Move Email Message
move_messageMove an email message to another mail folder by well-known name, display name, or folder ID; use it to archive, file, or delete messages in Microsoft 365 mailboxes.
Instructions
Move a message to another mail folder. Destination accepts a well-known name (archive, deleteditems, inbox, junkemail), a top-level folder display name, or a folder ID. A well-known name always wins over a custom folder of the same name, and the confirmation says which was used. Subfolders cannot be resolved by name — pass their ID. Moving to deleteditems is recoverable; use list_mail_folders to see what exists.
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>",
"destination": "<destination>"
},
"name": "move_message"
}
}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. | |
| message_id | Yes | The message ID, or a short ref from scan_messages, to move | |
| destination | Yes | Destination folder: well-known name (e.g. archive), display name, or folder ID |