label_message
Adds system or user labels to Gmail messages, including lists of up to 100 messages, to archive, mark read, star, or categorize. Optionally creates missing user labels.
Instructions
Add labels to a message (or to a list of messages). Labels: system IDs (INBOX, UNREAD, STARRED, IMPORTANT, CATEGORY_*) or user label IDs (list_labels), or their exact names. Archive = unlabel INBOX; mark read = unlabel UNREAD; star = label STARRED. Trash: trash_*; spam, sent and drafts: never. Reversible, no confirmation needed; at most 100 items per call.
Args: messageId: message ID, or a list of IDs. labelIds: labels to add (IDs or names). createMissing: create missing user labels (default false; otherwise an error).
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": {
"messageId": "<messageId>",
"labelIds": "<labelIds>"
},
"name": "label_message"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| labelIds | Yes | ||
| messageId | Yes | ||
| createMissing | No |