GOOGLESUPER_ADD_LABEL_TO_EMAIL

Adds and/or removes specified Gmail labels for a message; ensure message_id and all label_ids are valid (use 'listLabels' for custom label IDs).

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-add-label-to-email.md

WHAT IT DOES

What GOOGLESUPER_ADD_LABEL_TO_EMAIL does on Google Super

AI agents use GOOGLESUPER_ADD_LABEL_TO_EMAIL 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
`user_id`	string	—	User's email address or 'me' for the authenticated user.
`message_id`	string	—	Immutable ID of the message to modify (e.g., from 'fetchEmails' or 'fetchMessagesByThreadId').
`add_label_ids`	array	—	Label IDs to add. For custom labels, obtain IDs via 'listLabels'. System labels (e.g., 'INBOX', 'SPAM', 'STARRED', 'IMPORTANT') can be used, but immutable syste
`remove_label_ids`	array	—	Label IDs to remove. For custom labels, obtain IDs via 'listLabels'. System labels can be used, but immutable system labels like 'DRAFT' and 'SENT' cannot be ad

Parameters from the server's own tool schema.

RISK

Why GOOGLESUPER_ADD_LABEL_TO_EMAIL is rated Medium

This tool modifies email organization state by applying or removing labels, making it a Write operation. It does not read-only (it changes state), is not destructive (changes are reversible), does not execute code, and has no financial impact.

From the tool's definition Tool description states it 'Adds and/or removes specified Gmail labels for a message', which modifies email metadata. The action is reversible—labels can be added or removed without permanently deleting or destroying data.

Attacks that exploit this kind of access

RECOMMENDED RULE

The rule that runs GOOGLESUPER_ADD_LABEL_TO_EMAIL 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_ADD_LABEL_TO_EMAIL, this is the rule to start with:

GOOGLESUPER_ADD_LABEL_TO_EMAIL Rate-limited

GOOGLESUPER_ADD_LABEL_TO_EMAIL 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_ADD_LABEL_TO_EMAIL": {
      "limits": [
        {
          "counter": "googlesuper_add_label_to_email_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_ADD_LABEL_TO_EMAIL call is checked against it from then on.

FAQ

Questions about GOOGLESUPER_ADD_LABEL_TO_EMAIL

What does the GOOGLESUPER_ADD_LABEL_TO_EMAIL tool do? +

Adds and/or removes specified Gmail labels for a message; ensure message_id and all label_ids are valid (use 'listLabels' for custom label IDs). 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_ADD_LABEL_TO_EMAIL accept? +

GOOGLESUPER_ADD_LABEL_TO_EMAIL accepts 4 parameters: user_id, message_id, add_label_ids, remove_label_ids. The full parameter table on this page comes from the server's own tool schema.

How do I enforce a policy on GOOGLESUPER_ADD_LABEL_TO_EMAIL? +

Register the Google Super MCP server in PolicyLayer and add a rule for GOOGLESUPER_ADD_LABEL_TO_EMAIL: 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_ADD_LABEL_TO_EMAIL? +

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

Can I rate-limit GOOGLESUPER_ADD_LABEL_TO_EMAIL? +

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

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

GOOGLESUPER_ADD_LABEL_TO_EMAIL 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

add-tag on Kanban MCP Server →kb_add on Persistent Kb →create-label on Meme MCP Server →add_video on Mcptube Vision → The MCP Attack Database →

Guides

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