imap_bulk_update_flags
Update flags on up to 500 IMAP messages in one call, adding or removing flags such as Seen or Flagged for the same mailbox.
Instructions
Update flags on up to 500 messages in one operation
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_ids": "<message_ids>"
},
"name": "imap_bulk_update_flags"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| add_flags | No | Flags to add (e.g., `\\Seen`, `\\Flagged`) | |
| account_id | No | Account identifier (defaults to `"default"`) | default |
| message_ids | Yes | List of stable message identifiers (all must be from the same mailbox) | |
| 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 |