apple-mail-mcp

Overview

Apple Mail MCP is a specialized MCP server designed for macOS users who need advanced email search and management capabilities. It distinguishes itself from competitors by using FTS5 indexing to perform full-text searches across entire mailboxes, including older messages that other servers miss. The implementation focuses on performance with direct .emlx file reading (~3ms per email) and efficient search operations (~7ms for subject searches).

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• list_accountslist_accounts()

  List email accounts

  Try:List all my email accountsTry:What email accounts do I have configured?
• list_mailboxeslist_mailboxes(account?)

  List mailboxes

  Try:Show me all mailboxes in my inboxTry:List mailboxes for my work account
• get_emailsget_emails(filter?, limit?)

  Get emails — all, unread, flagged, today, last_7_days

  Try:Show me all unread emailsTry:Get my flagged messages from the last 7 days
• get_emailget_email(message_id)

  Get single email with full content + attachments

  Try:Show me email with ID 12345Try:Display the full content of message 67890
• searchsearch(query, scope?, before?, after?, highlight?)

  Search — all, subject, sender, body, attachments

  Try:Search for emails about quarterly reportsTry:Find messages from Sarah about the project
• get_email_linksget_email_links(message_id)

  Extract links from an email

  Try:Get all links from message 12345Try:Show me the links in that email about the conference
• get_email_attachmentget_email_attachment(message_id, filename)

  Extract attachment content

  Try:Get the invoice.pdf from message 12345Try:Download the attachment from email 67890
• get_attachmentget_attachment(message_id, filename)

  Deprecated — use get_email_attachment()

  Try:Get the document from message 12345Try:Extract the attachment from email 67890

Comparable tools

Installation

pipx install apple-mail-mcp

{
  "mcpServers": {
    "mail": {
      "command": "apple-mail-mcp"
    }
  }
}

apple-mail-mcp index --verbose

FAQ

Is this only for Apple Mail?

Yes, this MCP server is specifically designed for Apple Mail on macOS and requires AppleScript access to the mail database.

How does it handle large mailboxes?

It uses FTS5 indexing to enable efficient searching across large mailboxes without timeout issues that affect competitors' AppleScript-based implementations.

Compare apple-mail-mcp with