Skip to content

Add Google Sheets native Tables MCP tools#128

Merged
freema merged 1 commit into
freema:mainfrom
aldoborrero:feature/google-sheets-tables
Jul 10, 2026
Merged

Add Google Sheets native Tables MCP tools#128
freema merged 1 commit into
freema:mainfrom
aldoborrero:feature/google-sheets-tables

Conversation

@aldoborrero

Copy link
Copy Markdown
Contributor

Summary

  • Add first-class MCP tools for Google Sheets native Tables: add, update, delete, and get tables.
  • Add shared table helpers for typed column mapping, dropdown data validation, A1/GridRange handling, overlap checks, and response formatting.
  • Register the new tools and document them in the README.
  • Fix sheet name resolution for tabs with numeric sheetId 0.

Validation / error handling

  • Requires explicit update table field masks.
  • Validates table ranges, column count vs range width, sheet name/range mismatches, unknown sheets/tables, and overlapping existing tables.

Tests

  • Added unit tests for table tool handlers and sheetId 0 lookup.

Checks

  • npm run typecheck
  • npm run test:run
  • npm run build
  • npm run lint
  • npm run format:check

@freema freema merged commit e1d4c0e into freema:main Jul 10, 2026
3 checks passed
freema added a commit that referenced this pull request Jul 10, 2026
Ship Google Sheets native Tables support from #128 (@aldoborrero):

- sheets_add_table / sheets_update_table / sheets_delete_table / sheets_get_tables
- Fix sheet name resolution for tabs with sheetId 0

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@freema

freema commented Jul 10, 2026

Copy link
Copy Markdown
Owner

Thanks @aldoborrero, great contribution! 🎉

I've merged it and shipped it in v1.9.0 — it's now on npm as mcp-gsheets@1.9.0 and in the MCP Registry.

Nice catch on the sheetId: 0 bug as well, I appreciate the fix 👍

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants