macOS Mail MCP Server

by marius-cetanas

MCP server connecting Claude to macOS Mail.app via AppleScript

1Node.jsstdio

context tax

pending

security

pending

cold start

pending

freshness

pending

Our reading of macOS Mail, from the data

macOS Mail is a ai & llm tools MCP server from marius-cetanas.

We haven't measured its tool list yet, so its token cost is unknown.

With 1 GitHub stars it ranks #978 of 3,169 ai & llm tools servers we index.

It runs locally on your machine over stdio.

Install macOS Mail MCP server

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

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

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

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

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "macos-mail": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "macos-mail-mcp"
      ]
    }
  }
}

Add to .vscode/mcp.json in your workspace.

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

Add to ~/.codeium/windsurf/mcp_config.json.

Freshness

Not enough public signals yet to judge maintenance.

Last commit (default branch)
2026-10-12 · 6d ago · GitHub
Latest release
2026-09-15 · 33d ago · GitHub · v2.1.1
Package published
no data · npm/PyPI
Registry entry updated
no data · official registry

How it compares in AI & LLM Tools

Against the most-starred ai & llm tools servers we index. Token cost is per model turn, measured from each server's live tool list.

Server	Stars	Tools	Tokens / turn	Freshness	Runs
macOS Mail (this)	1	—	not measured	—	local
Memory	91,356	—	not measured	Active	local
Claude Flow	76,638	—	not measured	Active	local
Next AI Draw.io	36,318	—	not measured	—	local
Serena Agent	30,371	—	not measured	Active	local
Trycua	30,160	—	not measured	Active	—

All ai & llm tools MCP servers

FAQ

›How do I install the macOS Mail MCP server in Claude Code?

Run: claude mcp add macos-mail -- npx -y macos-mail-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does macOS Mail require an API key?

No required environment variables are declared in its published metadata.

›Can I use macOS Mail as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is macOS Mail in the official MCP registry?

No. It was indexed from npm.

Sources and method

GitHub repository: fetched 2026-10-19
Package registry (npm / PyPI): listed
Last checked against all sources: 2026-10-19

The description, packages and links come from the maintainer's own published metadata. Token cost, security signals, freshness and the reading above are MCPSkillHub's own measurements; see the methodology. Spot an error? Request a correction or claim the listing.