Skip to main content
Glama

Sheets Delete View

sheets_delete_view
DestructiveIdempotent

Delete any shared saved view, including the first, without changing rows, columns, or cells. At least one saved view must remain. Pass the current view version from sheets.get.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
viewIdYes
sheetIdYes
idempotencyKeyYesStable key for one logical mutation. Reuse the identical key and payload after an ambiguous outcome; different work or batches need different keys. Inspect receipts or live state before retrying.
expectedVersionYes

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
viewIdYes
streamSequenceYes
viewsOrderVersionYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.1/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare destructiveHint=true, idempotentHint=true, and readOnlyHint=false, so the safety profile is covered. The description adds value beyond them by bounding the blast radius (rows/columns/cells untouched), stating the invariant that one view must survive, and pointing at sheets.get for the optimistic-concurrency token.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three short sentences with the core action front-loaded and no filler. The 'including the first' clause is slightly awkward phrasing but does carry a distinct constraint, so it earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return-value documentation is not required, and annotations carry the safety/idempotency semantics. The description covers the destructive scope, the remaining-view invariant, and version sourcing — an agent has enough to invoke it correctly, though the two UUID identifiers are unexplained.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 25% (only idempotencyKey is documented), so the description must compensate. It does explain the provenance of expectedVersion ('the current view version from sheets.get'), but viewId and sheetId are left entirely implicit, so it only partly fills the gap.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource ('Delete ... saved view') and immediately scopes it ('without changing rows, columns, or cells'), which cleanly separates it from sibling mutation tools like sheets_delete_rows, sheets_delete_column, and sheets_update_view. The phrase 'any shared saved view, including the first' also tells the agent there is no protected default view.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives a real precondition ('At least one saved view must remain') and routes the agent to sheets.get for the required version value, which is genuinely actionable. It stops short of naming alternatives such as sheets_update_view or sheets_reorder_views when the intent is to modify rather than remove a view.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources