MCP tool · Orientation
organize_mail
Organize a mailbox: move messages between folders, mark read/unread, star/unstar (flag/unflag), move to Trash (trash), and create or delete folders.
organize_mail
Description
Organize a mailbox: move messages between folders, mark read/unread, star/unstar (flag/unflag), move to Trash (trash), and create or delete folders. Writes need the write:email scope. trash only moves to the Trash folder — nothing here permanently deletes a message, and delete_folder refuses system folders and non-empty folders. Every action answers with the folders' read-back counters as proof.
Input
| Name | Type | Description |
|---|---|---|
address
required
|
string |
The full mailbox address, e.g. [email protected].
|
action
required
|
enum |
move needs destination; move/trash/mark_*/flag/unflag need uids; create_folder/delete_folder need folder only. One of move, mark_read, mark_unread, flag, unflag, trash, create_folder, delete_folder.
|
folder
|
string |
The folder the messages are in (default inbox) — or, for create_folder/delete_folder, the folder to create/delete.
|
destination
|
string |
For move: the folder to move the messages into, from list_mail_folders.
|
uids
|
string |
The message uids to act on, from search_mail — a comma list (3,7,9) or range (1:20).
|