delete_range
Deletes the content in [start_index, end_index) — text, inline images, whole tables or any mix, as long as the range does not cut across a table cell boundary. Get fresh indexes from read_document_text first; every delete shifts all later indexes down. Deleting a paragraph's trailing newline merg...
This record as markdown: /tools/a1-x-tech-mcp-google-docs/delete-range.md
What delete_range does on Mcp Google Docs
AI agents call delete_range to permanently remove resources in Mcp Google Docs, typically in cleanup and lifecycle workflows. It does its job in a single call, and there is no undo.
| Parameter | Type | Required | Description |
|---|---|---|---|
tab_id | string | — | Tab to target (from list_tabs). Omit for the first/only tab. |
end_index | integer | Yes | End of the range to delete (exclusive). |
segment_id | string | — | Header/footer/footnote segment id (from get_document). Omit for the document body. |
document_id | string | Yes | The document id — the long id from the document URL (docs.google.com/document/d/<documentId>/edit) or from create_document output. |
start_index | integer | Yes | Start of the range to delete (inclusive). |
Parameters from the server's own tool schema.
Why delete_range is rated Critical
An AI agent that decides to call delete_range doesn't hesitate, doesn't double-check, and doesn't stop at one. Whatever it removes from Mcp Google Docs is gone. There is no undo for destructive operations.
Risk signalsBulk/mass operation — affects multiple targets
Attacks that exploit this kind of access
The rule that runs delete_range safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Mcp Google Docs, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For delete_range, this is the rule to start with:
delete_range is removed from the agent's tool list entirely, so the agent never calls it. The rest of the server keeps working.
The button opens the PolicyLayer dashboard: create your workspace, connect Mcp Google Docs, apply this rule, and every delete_range call is checked against it from then on.
Questions about delete_range
Deletes the content in [start_index, end_index) — text, inline images, whole tables or any mix, as long as the range does not cut across a table cell boundary. Get fresh indexes from read_document_text first; every delete shifts all later indexes down. Deleting a paragraph's trailing newline merges it with the next paragraph. The tab's final newline cannot be deleted. This is final — there is no undo through the API. It is categorised as a Destructive tool in the Mcp Google Docs MCP Server, which means it can permanently delete or destroy data. Block by default and require explicit approval.
delete_range accepts 5 parameters: tab_id, end_index, segment_id, document_id, start_index. Required: end_index, document_id, start_index. The full parameter table on this page comes from the server's own tool schema.
Register the Mcp Google Docs MCP server in PolicyLayer and add a rule for delete_range: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Mcp Google Docs. Nothing to install.
delete_range is a Destructive tool with critical risk. Critical-risk tools should be blocked by default and only enabled with explicit human approval.
Yes. Add a rate_limit block to the delete_range rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for delete_range. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
delete_range is provided by the Mcp Google Docs MCP server (@a1-x-tech/mcp-google-docs). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Mcp Google Docs, and thousands of servers like it.
Across the catalogue