GOOGLESUPER_BATCH_MODIFY_MESSAGES

Modify labels on multiple Gmail messages in one efficient API call. Supports up to 1,000 messages per request for bulk operations like archiving, marking as read/unread, or applying custom labels.

SERVERGoogle Super SOURCEgooglesuper

Medium RISK CLASS

Category Write

Parameters 40 required

Recommended Rate-limitedsee the rule below

Registry record Grade F, identity unverified Pull the record →

This record as markdown: /tools/googlesuper/googlesuper-batch-modify-messages.md

WHAT IT DOES

What GOOGLESUPER_BATCH_MODIFY_MESSAGES does on Google Super

AI agents use GOOGLESUPER_BATCH_MODIFY_MESSAGES to create or update resources in Google Super, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Google Super environment.

Parameter	Type	Required	Description
`userId`	string	—	User's email address or 'me' for the authenticated user.
`messageIds`	array	—	List of message IDs to modify. Maximum 1,000 message IDs per request. Get message IDs from GMAIL_FETCH_EMAILS or GMAIL_LIST_THREADS actions.
`addLabelIds`	array	—	List of label IDs to add to the messages. Common label IDs: INBOX, STARRED, IMPORTANT, SENT, DRAFT, SPAM, TRASH, UNREAD. Use GMAIL_LIST_LABELS to get custom lab
`removeLabelIds`	array	—	List of label IDs to remove from the messages. Common use cases: Remove 'UNREAD' to mark as read, remove 'INBOX' to archive, remove 'SPAM' to unmark spam. Leave

Parameters from the server's own tool schema.

RISK

Why GOOGLESUPER_BATCH_MODIFY_MESSAGES is rated Medium

The tool modifies Gmail message labels and states (archive, read/unread status, custom labels) in bulk. This is a Write operation because: (1) it creates/modifies data (label assignments, read status), (2) changes are reversible (labels can be removed, messages unarchived, status toggled), and (3) it has no destructive or financial impact.

From the tool's definition Tool description states it 'Modify labels on multiple Gmail messages' and supports 'bulk operations like archiving, marking as read/unread, or applying custom labels.' These are reversible modifications to message state/metadata.

Attacks that exploit this kind of access

RECOMMENDED RULE

The rule that runs GOOGLESUPER_BATCH_MODIFY_MESSAGES safely

PolicyLayer is an MCP gateway: it sits between your AI agents and Google Super, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For GOOGLESUPER_BATCH_MODIFY_MESSAGES, this is the rule to start with:

GOOGLESUPER_BATCH_MODIFY_MESSAGES Rate-limited

GOOGLESUPER_BATCH_MODIFY_MESSAGES stays usable, but capped: an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.

View as policy code

policy.json

{
  "version": "1",
  "default": "deny",
  "tools": {
    "GOOGLESUPER_BATCH_MODIFY_MESSAGES": {
      "limits": [
        {
          "counter": "googlesuper_batch_modify_messages_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}

LIMIT THIS TOOL → Instant setup, no code required.

The button opens the PolicyLayer dashboard: create your workspace, connect Google Super, apply this rule, and every GOOGLESUPER_BATCH_MODIFY_MESSAGES call is checked against it from then on.

FAQ

Questions about GOOGLESUPER_BATCH_MODIFY_MESSAGES

What does the GOOGLESUPER_BATCH_MODIFY_MESSAGES tool do? +

Modify labels on multiple Gmail messages in one efficient API call. Supports up to 1,000 messages per request for bulk operations like archiving, marking as read/unread, or applying custom labels. It is categorised as a Write tool in the Google Super MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

What parameters does GOOGLESUPER_BATCH_MODIFY_MESSAGES accept? +

GOOGLESUPER_BATCH_MODIFY_MESSAGES accepts 4 parameters: userId, messageIds, addLabelIds, removeLabelIds. The full parameter table on this page comes from the server's own tool schema.

How do I enforce a policy on GOOGLESUPER_BATCH_MODIFY_MESSAGES? +

Register the Google Super MCP server in PolicyLayer and add a rule for GOOGLESUPER_BATCH_MODIFY_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 Google Super. Nothing to install.

What risk level is GOOGLESUPER_BATCH_MODIFY_MESSAGES? +

GOOGLESUPER_BATCH_MODIFY_MESSAGES is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.

Can I rate-limit GOOGLESUPER_BATCH_MODIFY_MESSAGES? +

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

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

GOOGLESUPER_BATCH_MODIFY_MESSAGES is provided by the Google Super MCP server (googlesuper). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

KEEP EXPLORING

More on Google Super, and thousands of servers like it.

This server

All 200 Google Super tools →

Across the catalogue

The MCP Attack Database →

Guides

Govern customer-ops agents →Argument validation →Scoped token →