Apple Mail MCP Server

Name: Apple Mail MCP Server
Author: io.github.JonathanRReed

io.github.JonathanRReed/apple-mcp-mail

Repository Registry

What is the Apple Mail MCP server?

Read, search, compose, and send emails via Apple Mail on macOS.

How to install Apple Mail

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

APPLE_MAIL_MCP_SAFETY_PROFILE
Safety mode for Mail operations: safe_readonly, safe_manage, or full_access.
APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT
Directory attachments may be saved to or attached from. Unset disables attachment file access.
APPLE_MAIL_MCP_VISIBLE_DRAFTS
Whether compose tools open visible draft windows in Mail.app.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "apple-mcp-mail": {
      "command": "uvx",
      "args": [
        "apple-mcp-mail"
      ],
      "env": {
        "APPLE_MAIL_MCP_SAFETY_PROFILE": "<YOUR_APPLE_MAIL_MCP_SAFETY_PROFILE>",
        "APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT": "<YOUR_APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT>",
        "APPLE_MAIL_MCP_VISIBLE_DRAFTS": "<YOUR_APPLE_MAIL_MCP_VISIBLE_DRAFTS>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "apple-mcp-mail": {
      "command": "uvx",
      "args": [
        "apple-mcp-mail"
      ],
      "env": {
        "APPLE_MAIL_MCP_SAFETY_PROFILE": "<YOUR_APPLE_MAIL_MCP_SAFETY_PROFILE>",
        "APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT": "<YOUR_APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT>",
        "APPLE_MAIL_MCP_VISIBLE_DRAFTS": "<YOUR_APPLE_MAIL_MCP_VISIBLE_DRAFTS>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "apple-mcp-mail": {
      "command": "uvx",
      "args": [
        "apple-mcp-mail"
      ],
      "env": {
        "APPLE_MAIL_MCP_SAFETY_PROFILE": "<YOUR_APPLE_MAIL_MCP_SAFETY_PROFILE>",
        "APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT": "<YOUR_APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT>",
        "APPLE_MAIL_MCP_VISIBLE_DRAFTS": "<YOUR_APPLE_MAIL_MCP_VISIBLE_DRAFTS>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "apple-mcp-mail": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "apple-mcp-mail"
      ],
      "env": {
        "APPLE_MAIL_MCP_SAFETY_PROFILE": "<YOUR_APPLE_MAIL_MCP_SAFETY_PROFILE>",
        "APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT": "<YOUR_APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT>",
        "APPLE_MAIL_MCP_VISIBLE_DRAFTS": "<YOUR_APPLE_MAIL_MCP_VISIBLE_DRAFTS>"
      }
    }
  }
}

Claude Code

claude mcp add apple-mcp-mail --env APPLE_MAIL_MCP_SAFETY_PROFILE=<YOUR_APPLE_MAIL_MCP_SAFETY_PROFILE> --env APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT=<YOUR_APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT> --env APPLE_MAIL_MCP_VISIBLE_DRAFTS=<YOUR_APPLE_MAIL_MCP_VISIBLE_DRAFTS> -- uvx apple-mcp-mail