feat(docs,sheets,slides): add docs.insertTable, sheets.getRanges, and slides.replaceImage

[matheusrmorgado]

Summary

Fixes #395 by adding one high-leverage tool to each of the Docs, Sheets, and Slides surfaces. All three follow the existing service-class, feature-group, and test patterns, and none of them adds a new OAuth scope (each tool reuses its feature group's existing scope, so the consent surface is unchanged).

docs.insertTable (docs.write group, default on)

Inserts a rows x columns table at the end of the body (default) or at a specific index, optionally pre-filled with cell data in the same call:

docs.insertTable({
  documentId: "...",
  rows: 3, columns: 2,
  data: [["Metric", "Value"], ["Revenue", "$1.2M"], ["Churn", "2.1%"]]
})

Cell fill works by re-reading the document to locate the inserted table, then applying one insertText per non-empty cell in reverse document order so earlier indexes remain valid. data dimensions are validated against rows/columns before any API call. This avoids the brittle alternative of asking the model to compute table-cell indexes by hand after insertion.

sheets.getRanges (sheets.read group, default on, readOnlyHint)

Batch read of multiple A1 ranges via spreadsheets.values.batchGet — one API call instead of N sheets.getRange calls when pulling disjoint ranges (e.g. KPI cells across sheets). Supports valueRenderOption (FORMATTED_VALUE default / UNFORMATTED_VALUE / FORMULA) and majorDimension (ROWS default / COLUMNS). Results are returned in request order.

slides.replaceImage (slides.write group, default off, like the other write tools)

Replaces an existing image by imageObjectId with a new URL via the replaceImage batchUpdate request, preserving the original position and size. imageReplaceMethod: CENTER_INSIDE (default) or CENTER_CROP. Pairs naturally with slides.getImages / slides.getMetadata and with slides.replaceAllText for template-deck workflows (refresh a chart, fill an image placeholder).

What's included

• Service methods in DocsService, SheetsService, SlidesService following the existing logging/error-shape conventions (isError on failures)
• Tool registration in index.ts with Zod schemas (integer/positive constraints, enums, min(1) on the ranges array) and readOnlyHint on the read tool
• feature-config.ts entries in the matching feature groups
• Jest coverage (12 new tests): request shapes, defaults, URL-to-ID extraction, reverse-order cell fill, dimension validation, empty-result and error paths
• docs/index.md entries for the default-enabled tools (the Slides section lists only read tools today, so slides.replaceImage follows the existing convention of being config-documented only)
• Skill recipes: google-docs (insertTable usage and why fill-at-insert beats post-hoc index math) and google-sheets (when to prefer getRanges over repeated getRange)

Verification

npm run test && npm run lint && npm run format:check && npx tsc --noEmit --project workspace-server

All passing locally: 29 suites, 632 tests (620 existing + 12 new), eslint and prettier clean, tsc clean.

Happy to split this into three per-product PRs if you prefer smaller reviews — the three changes are fully independent.

Made with Cursor

[google-cla]

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

[gemini-code-assist]

Code Review

This pull request adds three new tools to the Google Workspace extension: docs.insertTable for inserting pre-filled tables in Google Docs, sheets.getRanges for batch-retrieving multiple disjoint ranges in Google Sheets, and slides.replaceImage for replacing images in Google Slides. The feedback highlights a critical bug in DocsService.ts where using cellStart + 1 for cell text insertion will trigger a 400 Bad Request error on empty cells, requiring a shift to cellStart and a corresponding test update. Additionally, the error handler in SheetsService.ts for getRanges needs to include isError: true to ensure MCP clients can correctly identify tool execution failures.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.