imap_update_message_flags
Add or remove IMAP flags such as \Seen or \Flagged on a specific message to control read status and importance markers directly from your mailbox.
Instructions
Add or remove IMAP flags
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": {
"message_id": "<message_id>"
},
"name": "imap_update_message_flags"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| add_flags | No | Flags to add (e.g., `\Seen`, `\Flagged`, `Important`) | |
| account_id | No | Account identifier (defaults to `"default"`) | default |
| message_id | Yes | Stable message identifier | |
| remove_flags | No | Flags to remove |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | Tool-specific data payload | |
| meta | Yes | Execution metadata (timestamp, duration) | |
| summary | Yes | Human-readable summary of the operation outcome |