Modify Labels on a Gmail Thread
gmail_modify_thread_labelsAdd or remove labels on all messages in a Gmail thread at once, using thread ID and label IDs for consistent updates.
Instructions
Add or remove labels on all messages in a Gmail thread at once.
Args:
thread_id (string): The Gmail thread ID
add_label_ids (string[]): Label IDs to add to all messages in the thread
remove_label_ids (string[]): Label IDs to remove from all messages in the thread
Returns: Updated thread with message count and affected message IDs.
Examples:
Use when: "Label this entire conversation as 'Compliance'"
Use when: "Archive this thread" -> remove_label_ids: ["INBOX"]
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": {
"thread_id": "<thread_id>"
},
"name": "gmail_modify_thread_labels"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| thread_id | Yes | Gmail thread ID | |
| add_label_ids | No | Label IDs to add to all messages in the thread | |
| remove_label_ids | No | Label IDs to remove from all messages in the thread |