Apple Mail MCP

Name: Apple Mail MCP
Author: imdinu

imdinu

Lets agents access Apple Mail: list accounts and mailboxes, fetch emails with filters, search bodies via an FTS5 index and extract attachments.

Setup

Choose your client, copy the config, then fill in any required environment variables.

claude mcp add apple-mail -- uvx apple-mail-mcp

~/.codex/config.toml

[mcp_servers.apple-mail]
command = "uvx"
args = ["apple-mail-mcp"]

# codex mcp add apple-mail -- uvx apple-mail-mcp

~/.cursor/mcp.json

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

.vscode/mcp.json

{
  "servers": {
    "apple-mail": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "apple-mail-mcp"
      ]
    }
  }
}

~/.gemini/settings.json

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

claude_desktop_config.json

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

.trae/mcp.json

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