Move emails
move_emailsMove specified messages into a chosen folder so they exist only in the destination. Use message ids from search or thread results; flags stay untouched and Trash is refused.
Instructions
Move one or more messages into a folder. They are removed from every folder they were in and end up only in the destination. Use this when the user names a destination ("put this in Projects", "move it back to the inbox"). Takes message ids from search_emails or get_thread. The mailbox is resolved the same way as the search_emails mailbox filter and is never created; an unknown name returns the folders that exist. Read state and flags (to-do, starred) are untouched; use mark_emails to change them. Re-running it on the same ids is harmless. To archive use archive_emails; to delete use trash_emails — this tool refuses Trash. Reports how many messages moved and lists any id the server refused.
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": {
"ids": "<ids>",
"mailbox": "<mailbox>"
},
"name": "move_emails"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | Yes | Message ids to act on (1–50), as returned by search_emails or get_thread. To act on a whole conversation, pass every id get_thread lists. | |
| mailbox | Yes | Destination folder. The standard places — Inbox, Archive, Sent, Drafts, Junk — resolve to the folder holding that role whatever the server calls it; any other value must match an existing folder name exactly (case-insensitive). Folders are never created. Trash is not accepted here: use trash_emails. |