Modify message
modify_messageMark emails read/unread, star/unstar, add/remove labels, move to folder or archive, and update UID after move.
Instructions
Mark read/unread, star/unstar, add/remove labels (Gmail labels, Outlook categories), move to a folder or archive. A move can change the id of the message: when the result carries moved_uid, use that id from then on.
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>",
"uid": "<uid>"
},
"name": "modify_message"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uid | Yes | uid from search_messages | |
| seen | No | ||
| folder | No | Default: Gmail All Mail, else INBOX | |
| account | Yes | list_accounts id | |
| archive | No | Remove from inbox (Gmail) or move to Archive | |
| flagged | No | ||
| move_to | No | Destination folder path | |
| add_labels | No | Gmail only | |
| create_folder | No | With move_to: create the folder first if it does not exist | |
| remove_labels | No | Gmail only |