Contactsmcp

macos-mcp

MCP servers for macOS native apps — gives Claude Code, Claude Desktop, and any MCP client native access to Mail, Numbers, Contacts, Calendar, Reminders, and FaceTime / phone calls.

No API keys, no OAuth, no cloud services. Talks directly to macOS apps via AppleScript and URL schemes (tel://, facetime://). Runs locally on your Mac.

CUPS printing (printmcp) used to live here; it moved to office-mcp since it's a shell wrapper, not an AppleScript bridge.

Servers

Mail (mailappmcp) — 21 tools

Works with every email account configured in Mail.app — iCloud, Gmail, Outlook, Fastmail, you name it.

Numbers (numbersmcp) — 29 tools

Works with any open Numbers spreadsheet.

Contacts (@aernoud/contactsmcp) — 15 tools

Works with the system address book — all accounts synced to Contacts.app.

Calendar (calendarmcp) — 25 tools

Works with every calendar configured in Calendar.app — iCloud, Google, Exchange, local, you name it.

Reminders (@aernoud/remindersmcp) — 22 tools

Works with every reminder list configured in Reminders.app — iCloud, Exchange, local, you name it.

FaceTime (facetimemcp) — 3 tools

Initiates calls by handing URL schemes to open. Phone calls require an iPhone paired via Continuity (so macOS can route them through your phone).

Phone numbers are normalized + validated as E.164 (+15551234567); spaces, dashes, and parens are tolerated. macOS may show a confirmation prompt before dialing — there is no fully silent dial path, by design.

Requirements

• macOS (uses AppleScript — won't work on Linux/Windows)
• Node.js 18+

Install

From npm

npm install -g mailappmcp            # Mail server

npm install -g numbersmcp # Numbers server npm install -g @aernoud/contactsmcp # Contacts server npm install -g @aernoud/calendarmcp # Calendar server npm install -g @aernoud/remindersmcp # Reminders server npm install -g @aernoud/facetimemcp # FaceTime / phone calls

From source

git clone https://github.com/aernouddekker/macos-mcp.git

cd macos-mcp npm install npm run build

Configure

Claude Code

Add to ~/.claude/settings.json or your project's .mcp.json:

{

"mcpServers": { "mailappmcp": { "command": "npx", "args": ["-y", "mailappmcp"] }, "numbersmcp": { "command": "npx", "args": ["-y", "numbersmcp"] }, "contactsmcp": { "command": "npx", "args": ["-y", "@aernoud/contactsmcp"] }, "calendarmcp": { "command": "npx", "args": ["-y", "@aernoud/calendarmcp"] }, "remindersmcp": { "command": "npx", "args": ["-y", "@aernoud/remindersmcp"] }, "facetimemcp": { "command": "npx", "args": ["-y", "@aernoud/facetimemcp"] } } }

Claude Desktop / Cowork

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

{

"mcpServers": { "mailappmcp": { "command": "npx", "args": ["-y", "mailappmcp"] }, "numbersmcp": { "command": "npx", "args": ["-y", "numbersmcp"] }, "contactsmcp": { "command": "npx", "args": ["-y", "@aernoud/contactsmcp"] }, "calendarmcp": { "command": "npx", "args": ["-y", "@aernoud/calendarmcp"] }, "remindersmcp": { "command": "npx", "args": ["-y", "@aernoud/remindersmcp"] }, "facetimemcp": { "command": "npx", "args": ["-y", "@aernoud/facetimemcp"] } } }

How it works

Each server runs locally over stdio. The Mail, Numbers, and Contacts servers build AppleScript strings, execute them via osascript, and parse the structured output back into JSON. The Print server shells out to CUPS (lp, lpstat, lpoptions, cancel); the FaceTime server hands tel:// / facetime:// URLs to open. A shared package (@mailappmcp/shared) provides the AppleScript runner, the generic command runner (runCommand), string escaping, and delimiter-based parsing.

App lifecycle — leave as found

Mail, Calendar, Contacts, and Reminders nee