SkillFoxx

apple-mail-mcp

MCP server for Apple Mail on macOS: read, search, send and organize mail through AppleScript or IMAP and SMTP.

  • 111 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • The agent reads your mail and can send, forward and delete messages in your name.
  • It needs automation permissions and Full Disk Access.
All reasons and checks

sweetrb/apple-mail-mcpAuthor:sweetrb

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/sweetrb-apple-mail-mcp

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • The agent reads your mail and can send, forward and delete messages in your name.
  • It needs automation permissions and Full Disk Access.

This is third-party code. Review the repository files before installing.

What it does

The MCP server connects an agent to the Apple Mail client on a Mac. The agent reads the inbox, searches messages, drafts, replies, forwards and sorts mail into folders. Work runs through AppleScript and data stays on your machine. For some scenarios you can configure direct IMAP and SMTP access. Beyond messages, the server manages mailboxes and accounts, rules, templates and contacts, and `doctor` diagnoses permissions and backend state. Read results arrive as text and as structured JSON. For destructive operations the server counts the change in message numbers and can keep an audit log.

Who it is for. Mac users with Apple Mail who hand mail triage and drafting to Claude, Codex or another assistant.

Good fit when

  • You triage unread messages in the morning and pick the ones that need a reply.
  • An agent drafts a reply and you send it after reviewing.
  • Old newsletters have to be moved to the archive in bulk by a rule.
  • You need a personalized mailing to a recipient list with field substitution.
  • Mail is searched by sender, subject and date without browsing folders by hand.

Not a fit when

  • You have no Mac: the server works only with Apple Mail on macOS.
  • The agent must not be allowed to send mail without your approval.
  • The mailbox holds material that must not be shown to a connected model.

Example request

Show today's unread messages and draft replies to the two most urgent ones without sending them.

MCP

Transport
stdio
Authentication
not required

Limitations

The server runs only on macOS and drives the Apple Mail application. On first run macOS asks permission to automate Mail. Contact search needs Node.js 22.5 or newer and Full Disk Access, and smart mailboxes read a protected settings file and need the same access. A plugin install has no editable `env` block, so IMAP and SMTP settings live in a configuration file under `~/Library/Application Support/apple-mail-mcp/`. Agents need exact tool names and escaped backslashes in parameters. On macOS 15 and newer Mail wraps quoted text in blocks, and version 1.6.0 includes a fix.

How to disable. Remove the connection with `claude mcp remove apple-mail` or disable the plugin through `/plugin`. Revoke the Mail automation permission in macOS privacy settings.

FAQ

How do I connect Apple Mail MCP to Claude Code?

Run `claude mcp add apple-mail -s user -- npx -y apple-mail-mcp`. Or install the plugin with `/plugin marketplace add sweetrb/apple-mail-mcp` and `/plugin install apple-mail`, which also adds a mail skill.

Does the server work without a Mac?

No. It drives the Apple Mail application through AppleScript, so macOS is required. The README separately flags an unrelated project of the same name on PyPI.

What can the send tools do?

The `send-email`, `reply-to-message` and `forward-message` tools send mail. Draft creation lets you review first, and the README describes a safe sending order.

Which permissions will macOS ask for?

On first use macOS asks to allow Mail automation. Contact search and smart mailboxes additionally need Full Disk Access for the Node process.

Can I use IMAP instead of AppleScript?

Yes, for several tools you can configure IMAP and SMTP, and attachment and thread tools then route through IMAP. Passwords stay in the macOS Keychain, and setup is covered in the IMAP-SETUP guide.

Discussion

No questions or reviews yet.

MCP servers

An MCP server for Mail on Mac: an agent reads, searches, writes and sorts email and triages the inbox, with a read-only mode

MCP serverBroad access256

An MCP server for Apple Mail on macOS: search, reading, drafts, rules and attachments, with confirmation for dangerous steps.

MCP serverBroad access105

An MCP server for Apple Mail on macOS: 8 read tools and body search through an FTS5 index on large mailboxes

MCP serverBroad access74

An email MCP with 52 tools: the agent reads, searches, sends and sorts mail across several accounts over IMAP and SMTP, and schedules sends

MCP serverBroad access158

An MCP server for mail, calendar, contacts, reminders, notes and Safari: locally through macOS or over iCloud protocols.

MCP serverBroad access80

README in short

Installation for Claude Code, Codex, Hermes and Antigravity, a tool reference, auditing of destructive operations and known macOS limitations sit on one page.

README badge

Report a problem