apple-mail-mcp

Overview

The Apple Mail MCP server offers extensive functionality for email management through natural language commands. It provides tools for reading and searching emails, organizing them into mailboxes, composing new messages, managing drafts, handling attachments, and performing analytics. The server includes both read-only and writable modes, with safety limits to prevent accidental bulk operations. Additionally, it features a companion email management skill for expert workflows like Inbox Zero.

Try asking AI

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

• get_inbox_overview

  Dashboard with unread counts, folders, and recent emails

  Try:Show me my inbox overviewTry:What's in my unread inbox
• list_inbox_emails

  List emails with account/read-status filtering and optional content preview

  Try:List my unread emailsTry:Show recent emails from work
• search_emails

  Unified search — subject, sender, body text, dates, attachments, cross-account

  Try:Search for emails about project updatesTry:Find emails from Sarah last month
• get_email_thread

  Conversation thread view

  Try:Show me the full thread about the budgetTry:Get the conversation with John
• compose_email

  Send new emails (plain text or HTML body)

  Try:Compose a new email to the teamTry:Send a follow-up about the meeting
• reply_to_email

  Reply or reply-all with optional HTML body

  Try:Reply to the client proposalTry:Reply-all to the project update email
• forward_email

  Forward with optional message, CC/BCC

  Try:Forward the contract to legalTry:Forward the meeting notes to the team
• get_statistics

  Email analytics (volume, top senders, read ratios)

  Try:Show me my email statisticsTry:Analyze my email activity this month
• export_emails

  Export single emails or mailboxes to TXT/HTML

  Try:Export the thread about the acquisitionTry:Save my Sent folder as HTML
• get_top_senders

  Analyse most frequent senders by count or domain

  Try:Who emails me most oftenTry:Show my top 5 email domains
• get_awaiting_reply

  Find sent emails that haven't received a reply

  Try:Which emails am I waiting for replies onTry:Find unanswered client emails
• create_rich_email_draft

  Build a rich HTML .eml draft, open it in Mail, and optionally save it to Drafts

  Try:Create a newsletter draftTry:Make a formatted HTML email draft

Comparable tools

Installation

claude plugin marketplace add patrickfreyer/apple-mail-mcp
claude plugin install apple-mail@apple-mail-mcp

{
  "mcpServers": {
    "apple-mail": {
      "command": "uvx",
      "args": ["mcp-apple-mail"]
    }
  }
}

pip install mcp-apple-mail
claude mcp add apple-mail -- mcp-apple-mail

FAQ

What permissions are required for this MCP server?

The server requires Automation and Mail Data Access permissions in macOS System Settings > Privacy & Security > Automation.

Can I use this in read-only mode?

Yes, you can pass the --read-only flag to disable tools that send email while still allowing read access.

Compare apple-mail-mcp with