gmail_message_trash

Move a message to Trash via

Server Mcp Gmail knowledgeislands/mcp-gmail
Category Destructive
Risk class Critical
Parameters 00 required

What gmail_message_trash does on Mcp Gmail

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

Why gmail_message_trash needs a policy

Moving a message to Trash is a destructive action that removes the message from the inbox/current location. While Gmail trash can technically be recovered within 30 days, this is effectively a deletion operation from the user's perspective and is irreversible in typical workflows. Misuse by an AI agent could result in loss of important emails at scale.

From the tool's definition Move a message to Trash

Questions about gmail_message_trash

What does the gmail_message_trash tool do? +

Move a message to Trash via. It is categorised as a Destructive tool in the Mcp Gmail 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 gmail_message_trash? +

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

What risk level is gmail_message_trash? +

gmail_message_trash 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 gmail_message_trash? +

Yes. Add a rate_limit block to the gmail_message_trash 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 gmail_message_trash completely? +

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

gmail_message_trash is provided by the Mcp Gmail MCP server (knowledgeislands/mcp-gmail). 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.