Move multiple emails matching a search query to trash
AI agents call batch_delete_emails 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.
This tool irreversibly removes emails from active access based on a search query parameter. Even though Gmail retains trash for a period, the action cannot be undone in real-time and matches the Destructive category: it deletes data that requires manual recovery steps. Batch operations amplify risk—a malformed or overly broad search query could delete far more emails than intended.
From the tool's definition Tool performs 'Move multiple emails matching a search query to trash', and is named 'batch_delete_emails'.
Risk signalsBulk/mass operation — affects multiple targets
Attacks that exploit this kind of access
Move multiple emails matching a search query to trash. 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.
Register the Gmail MCP Server MCP server in PolicyLayer and add a rule for batch_delete_emails: 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.
batch_delete_emails 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 batch_delete_emails 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 batch_delete_emails. 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.
batch_delete_emails is provided by the Gmail MCP Server MCP server (samarth2001/gmail-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the 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 →