marius-cetanas/macos-mail-mcp

tools

• create_mailbox

  Create a new mailbox (top-level or nested under a parent)

• delete_message

  Delete a message (moves to Trash)

• flag_message

  Set/clear flag with optional color index (0-6)

• forward_message

  Forward a message to a new recipient

• get_account_detail

  Get full account details (server, port, SSL, mailbox count)

• get_mailbox_info

  Get mailbox details (message count, unread count)

• get_message

  Get full message content, headers, recipients, attachments. Mailbox name is optional — omit to search all mailboxes in the account.

• list_accounts

  List all mail accounts (name, type, enabled, emails)

• list_attachments

  List attachments with filename, MIME type, size, download status

• list_mailboxes

  List mailboxes for an account or all accounts

• list_messages

  List messages with pagination (limit/offset) and optional date filtering (after/before)

• mark_read

  Mark message as read or unread

• move_message

  Move a message to a different mailbox

• move_messages

  Bulk move multiple messages to a different mailbox in a single operation

• read_attachment

  Read text-based attachment content inline (.txt, .csv, .json, .html, .md, .xml, .log)

• reply_to_message

  Reply or reply-all to a message

• save_all_attachments

  Save all attachments from a message

• save_attachment

  Save a specific attachment to disk

• search_messages

  Search by subject, sender, or content with optional date filtering (after/before). Results include the mailbox name.

• send_message

  Send a new email with optional CC, BCC, and attachments