List all Mail.app accounts with their type, enabled status, and email addresses

Get detailed information about a specific Mail.app account by name

List mailboxes in a Mail.app account, or all mailboxes across all accounts

Create a new mailbox (folder) in a Mail.app account. Can create top-level or nested mailboxes.

Get detailed information about a specific mailbox in a Mail.app account

List messages in a mailbox with pagination. Provide accountName and mailboxName to scope the listing.

Get the full details of a single message by its ID, including body, headers, recipients, and attachments. If mailboxName is omitted, searches all mailboxes in the account (slower but useful when you don't know which mailbox the message is in).

Search messages by subject, sender, or content. Prefer 'subject' or 'sender' fields which are fast metadata lookups. The 'content' field searches message bodies and is significantly slower and less reliable — it may trigger full message downloads on IMAP accounts and can time out. WARNING: Mail.app loads all matching messages into memory before applying the limit, so searches on large mailboxes can be very slow. Always narrow results with mailboxName and accountName when possible.

Move a message to a different mailbox. Gmail uses labels rather than folders. Moving a message adds the destination label but may not remove the original.

Move multiple messages to a different mailbox in a single operation. More efficient than calling move_message multiple times.

Delete a message. Uses Mail's delete verb which routes to the correct Trash.

Set or clear the flag on a message. Optionally specify a flag colour index.

Mark a message as read or unread.

List all attachments for a message, including their name, MIME type, file size, and download status.

Save a specific attachment from a message to disk.

Save all downloaded attachments from a message to disk.

Read the text content of a text-based attachment inline. Supported types: .txt, .csv, .json, .html, .md, .xml, .log. Use save_attachment for binary files.

Compose and send a new email message as plain text. Returns success when the message is queued for sending; actual delivery is not confirmed. Check Mail's Sent or Outbox mailbox to verify delivery.

Reply to an existing email message. Does not support attachments (Mail.app limitation).

Forward an existing email message to a new recipient. Does not support adding new attachments (Mail.app limitation).