unlabel_message
Remove labels from Gmail messages by ID or name to archive, mark read, or unstar. Reversible, supports up to 100 messages per call.
Instructions
Remove labels from a message (or from 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 remove (IDs or names).
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": "unlabel_message"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| labelIds | Yes | ||
| messageId | Yes |