mcpbeat

Mac Mail MCP Server

io.github.wagamama/mac-mail-mcp
local only

Mac Mail MCP runs on your own machine — the client starts it, so there is no endpoint to ping. 294 installs a week from pypi. Last commit 15 Jul 2026.

Mac Mail MCP server with full-coverage FTS5 body search for local Apple Mail.

Installs per day peak 969 · avg 101 · -16% w/w
a month agotoday
294
Installs / week
pypi · mac-mail-mcp
0
Stars
0 open issues
15 Jul 2026
Last commit
0 releases in 90 days
GPL-3.0
License
Python

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add mac-mail-mcp -- uvx mac-mail-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mac-mail-mcp": {
      "args": [
        "mac-mail-mcp"
      ],
      "command": "uvx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.mac-mail-mcp]
command = "uvx"
args = ["mac-mail-mcp"]
.cursor/mcp.json
{
  "mcpServers": {
    "mac-mail-mcp": {
      "args": [
        "mac-mail-mcp"
      ],
      "command": "uvx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "mac-mail-mcp": {
      "args": [
        "mac-mail-mcp"
      ],
      "command": "uvx"
    }
  }
}

Mac Mail MCP — questions

Answers built from our own checks of this server.

Why is there no uptime for Mac Mail MCP?
Mac Mail MCP runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the pypi package mac-mail-mcp was installed 294 times last week.
How do I connect Mac Mail MCP?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls mac-mail-mcp straight from pypi; nothing to host, nothing to sign up for.
How many people use Mac Mail MCP?
The pypi package mac-mail-mcp was installed 294 times in the last week. Week over week that is -16%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Mac Mail MCP open source?
Yes — it is published under the GPL-3.0 licence, written in Python and 0 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.