Move Email Messages in Bulk
batch_move_messagesMove multiple messages to the same folder in one call, resolving the destination once and returning a single summary with any failures reported individually.
Instructions
Move several messages to the same folder in one call. Resolves the destination once and returns a single summary instead of one result per message. Reports any failures individually.
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>",
"destination": "<destination>"
},
"name": "batch_move_messages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mailbox | No | Email address of another mailbox to act on (delegated or shared), e.g. 'someone@example.com'. Omit for your own mailbox; required when this server signs in as an application. Only addresses this server is configured to allow will be accepted. | |
| destination | Yes | Destination folder: well-known name (e.g. archive), display name, or folder ID | |
| message_ids | Yes | Message IDs or scan_messages refs to move (max 50) |