List all mailboxes/folders with their IMAP paths and roles.

Search a mailbox. All filters are optional and combined with AND. Returns summaries, newest first.

Fetch a full message: headers, text + HTML body, and attachment metadata.

Fetch the conversation a message belongs to, ordered oldest to newest.

Save an attachment to a local temp file and return its path. Get the attachmentId from get_message.

Build an email and return it for the user to review. Does not send or save anything. Use this first, then send_email after the user approves.

Send an email NOW. Only call after the user has explicitly approved sending (ideally after a compose_preview).

Save an email to the Drafts mailbox so the user can review and send it themselves. Does not send.

Reply to an existing message. Set replyAll for reply-all. Like send_email, only call after explicit user approval. Threading headers are set automatically from the original.

Forward an existing message to new recipients. Only call after explicit user approval.

Move a message to another mailbox.

Mark a message read/unread and/or flagged/unflagged.

Move a message to the Archive mailbox.

Move a message to Trash (or expunge it if it is already in Trash).