MCP server for Google Spreadsheets
Server has 5 tools with complete input schemas and descriptions. Naming follows verb_noun convention (get_, update_, add_, batch_update_). Descriptions are present but generic (avg ~80 chars, below 194-char baseline). Parameters are typed with Zod but lack detailed constraints and format guidance. No output schemas documented. Error handling returns isError flag but lacks recovery guidance or actionable next steps. Missing tool annotations (readOnlyHint/destructiveHint). Composition is sound, tools are single-responsibility and chainable.
Add a new sheet to a Google Spreadsheet
Update values in multiple cell ranges of a Google Spreadsheet in a single operation
Get values from a specific sheet in a Google Spreadsheet
Get information about sheets in a Google Spreadsheet
Update values in specific cells of a Google Spreadsheet
No output schemas documented. LLMs cannot predict response structure or plan downstream tool calls. E.g., get_sheets returns SheetInfo[] but this is not visible in tool definition.
Descriptions are too generic and lack context for LLM selection. 'Get information about sheets' does not explain when to call this vs get_sheet_values, or what structure is returned. Baseline is 194 chars; these average ~80.
Missing tool annotations. update_cells and batch_update_cells are destructive (WRITE risk) but lack destructiveHint annotation. get_sheets and get_sheet_values are read-only but lack readOnlyHint. Agents cannot distinguish safe from risky tools.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 57 | 2026-07-28+ | v2 |
Error handling returns isError flag but no recovery guidance. E.g., 'Error: Sheet not found' gives LLM no actionable next step. Should suggest 'Call get_sheets() to list available sheets' or return available alternatives.
Parameter descriptions lack format constraints. E.g., 'range' accepts A1 notation but does not specify format, length limits, or invalid patterns. LLMs may pass 'A1:Z999999' or malformed ranges.