trash_gmail_messages

trash_gmail_messages

Server Gmail MCP Server stevesimpson418/gmail-mcp-server
Category Destructive
Risk class Critical
Parameters 00 required

What trash_gmail_messages does on Gmail MCP Server

AI agents call trash_gmail_messages to permanently remove resources in Gmail MCP Server — typically in cleanup and lifecycle workflows. It does its job in a single call, and there is no undo.

Why trash_gmail_messages needs a policy

Trashing emails is a near-irreversible destructive action (Gmail trash auto-purges after 30 days, and users may not notice). The tool name clearly implies deletion/trashing of Gmail messages. While technically recoverable within 30 days, it is conventionally classified as Destructive due to potential data loss. The plural 'messages' suggests bulk operation, increasing blast radius to high.

From the tool's definition Tool name 'trash_gmail_messages' — 'trash' indicates moving messages to trash, which is a deletion action. Sibling tools include 'bulk_archive_gmail', suggesting this tool may operate on multiple messages.

Questions about trash_gmail_messages

What does the trash_gmail_messages tool do? +

trash_gmail_messages. It is categorised as a Destructive tool in the Gmail MCP Server MCP Server, which means it can permanently delete or destroy data. Block by default and require explicit approval.

How do I enforce a policy on trash_gmail_messages? +

Register the Gmail MCP Server MCP server in PolicyLayer and add a rule for trash_gmail_messages: 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 Gmail MCP Server. Nothing to install.

What risk level is trash_gmail_messages? +

trash_gmail_messages is a Destructive tool with critical risk. Critical-risk tools should be blocked by default and only enabled with explicit human approval.

Can I rate-limit trash_gmail_messages? +

Yes. Add a rate_limit block to the trash_gmail_messages 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.

How do I block trash_gmail_messages completely? +

Set action: deny in the PolicyLayer policy for trash_gmail_messages. 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.

What MCP server provides trash_gmail_messages? +

trash_gmail_messages is provided by the Gmail MCP Server MCP server (stevesimpson418/gmail-mcp-server). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

// LOOK UP ANOTHER SERVER

Every MCP server has a record like this.

Type a name, get the same breakdown: verified identity, auth posture, risk grade, capabilities, recommended policy.

Teams ship this data inside their own products. See what a licence covers →

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.