macos-mail-mcp

[](https://www.npmjs.com/package/macos-mail-mcp) [](https://opensource.org/licenses/MIT) [](https://nodejs.org/) [](https://www.apple.com/macos/)

An MCP server for Apple Mail (macOS Mail.app) that connects Claude to your email via AppleScript. Provides 18 tools for reading, searching, managing, and composing emails.

Works with any email account configured in macOS Mail.app — iCloud, Gmail, Outlook/Exchange, Yahoo, Fastmail, custom IMAP/POP, etc. No code changes needed; just add the account in Mail.app and it becomes available through all 18 tools.

• macOS with Mail.app configured (with at least one email account)
• Node.js 18+
• Claude Code or Claude Desktop app

The easiest way — no cloning or building required:

Claude Code (CLI):

claude mcp add macos-mail-mcp -- npx macos-mail-mcp

Claude Desktop:

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "macos-mail-mcp": {
      "command": "npx",
      "args": ["macos-mail-mcp"]
    }
  }
}

Restart the Claude desktop app after adding the config.

If you prefer to build locally or want to contribute:

git clone https://github.com/marius-cetanas/macos-mail-mcp.git
cd macos-mail-mcp
npm install
npm run build

Then register with Claude Code:

claude mcp add --transport stdio --scope user macos-mail-mcp -- node /path/to/macos-mail-mcp/build/index.js

Or add to Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "macos-mail-mcp": {
      "command": "node",