apple-mail-mcp MCP server

MCP server giving AI assistants full access to Apple Mail - read, search, compose, organize & analyze emails via natural language

What apple-mail-mcp does

Summarised from the project README; check the repository for the latest details.

Tools exposed (20+)

• get_inbox_overview – Dashboard with unread counts, folders, and recent emails
• list_inbox_emails – List emails with account/read-status filtering and optional content preview
• get_mailbox_unread_counts – Unread counts per mailbox or per-account summary
• list_accounts – List all configured Mail accounts
• search_emails – Unified search — subject, sender, body text, dates, attachments, flag status/color, cross-account
• get_email_thread – Conversation thread view
• Organization
• list_mailboxes – Folder hierarchy with message counts
• create_mailbox – Create new mailboxes (supports nested paths)
• move_email – Move/archive emails with filters (subject, sender, date, read status, dry-run)
• update_email_status – Mark read/unread, flag/unflag (optional flag color) — by filters or message IDs
• manage_trash – Soft delete, permanent delete, empty trash (with dry-run)
• Composition
• compose_email – Send new emails (plain text or HTML body)
• reply_to_email – Reply or reply-all with optional HTML body
• forward_email – Forward with optional message, CC/BCC
• manage_drafts – Create, list, send, and delete drafts
• create_rich_email_draft – Build a rich HTML `.eml` draft, open it in Mail, and optionally save it to Drafts
• Attachments
• list_email_attachments – List attachments with names and sizes

Requirements

• macOS with Apple Mail configured
• Python 3.7+
• `fastmcp` (+ optional `mcp-ui-server` for dashboard)
• Claude Desktop or any MCP-compatible client
• Mail.app permissions: Automation + Mail Data Access (grant in System Settings > Privacy & Security > Automation)

How to install apple-mail-mcp

Listed on Socketlist – add this badge to your README:

Badge markdown[](https://socketlist.pages.dev/s/patrickfreyer-apple-mail-mcp/)

Maintain this project? Get it featured for free during launch →

Compare with klavis →

Related Productivity & Office MCP servers