gmail_apply_labels
Add or remove Gmail labels on specific messages across multiple accounts, with confirmation required for destructive TRASH or SPAM labels.
Instructions
Add and/or remove labels on Gmail messages. Label names may also be Gmail label IDs. Adding TRASH or SPAM destroys mail after Gmail's 30-day purge, so that requires confirm: true; removing them does not.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"account": "<account>",
"messageIds": "<messageIds>"
},
"name": "gmail_apply_labels"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account | Yes | Configured Gmail account alias, e.g. work, personal, support. | |
| confirm | No | Required, and must be true, when addLabelNames includes TRASH or SPAM. | |
| messageIds | Yes | ||
| addLabelNames | No | ||
| removeLabelNames | No |