Apple Tools (Unified)
local MCP serverApple Tools (Unified) is a local MCP server: Unified Apple ecosystem MCP server for macOS: Mail, Calendar, Notes, Files, Messages, and more. Install it from pypi as apple-tools-mcp.
Installation
Terminal
claude mcp add apple-tools-mcp -e APPLE_MAIL_MCP_SAFETY_PROFILE=... -e APPLE_CALENDAR_MCP_SAFETY_MODE=... -e APPLE_REMINDERS_MCP_SAFETY_MODE=... -e APPLE_FILES_MCP_SAFETY_MODE=... -e APPLE_FILES_MCP_ALLOWED_ROOTS=... -e APPLE_SYSTEM_MCP_SAFETY_MODE=... -e APPLE_CONTACTS_MCP_SAFETY_MODE=... -e APPLE_NOTES_MCP_SAFETY_MODE=... -e APPLE_MESSAGES_MCP_SAFETY_MODE=... -e APPLE_SHORTCUTS_MCP_SAFETY_MODE=... -e APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT=... -- uvx apple-tools-mcp
Run in your project folder. Add --scope user to use it everywhere.
Claude Desktop, Cursor & other clients
Add to claude_desktop_config.json or .cursor/mcp.json.
{
"mcpServers": {
"apple-tools-mcp": {
"command": "uvx",
"args": [
"apple-tools-mcp"
],
"env": {
"APPLE_MAIL_MCP_SAFETY_PROFILE": "...",
"APPLE_CALENDAR_MCP_SAFETY_MODE": "...",
"APPLE_REMINDERS_MCP_SAFETY_MODE": "...",
"APPLE_FILES_MCP_SAFETY_MODE": "...",
"APPLE_FILES_MCP_ALLOWED_ROOTS": "...",
"APPLE_SYSTEM_MCP_SAFETY_MODE": "...",
"APPLE_CONTACTS_MCP_SAFETY_MODE": "...",
"APPLE_NOTES_MCP_SAFETY_MODE": "...",
"APPLE_MESSAGES_MCP_SAFETY_MODE": "...",
"APPLE_SHORTCUTS_MCP_SAFETY_MODE": "...",
"APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT": "..."
}
}
}
}Fill in the environment variables with your own credentials.
What you need
- Runtime: Python with uv (runs with uvx) or Claude Desktop (one-click .mcpb bundle).
- MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
- Environment variables:
APPLE_MAIL_MCP_SAFETY_PROFILE,APPLE_CALENDAR_MCP_SAFETY_MODE,APPLE_REMINDERS_MCP_SAFETY_MODE,APPLE_FILES_MCP_SAFETY_MODE,APPLE_FILES_MCP_ALLOWED_ROOTS,APPLE_SYSTEM_MCP_SAFETY_MODE,APPLE_CONTACTS_MCP_SAFETY_MODE,APPLE_NOTES_MCP_SAFETY_MODE,APPLE_MESSAGES_MCP_SAFETY_MODE,APPLE_SHORTCUTS_MCP_SAFETY_MODE,APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT
Summary
Unified Apple ecosystem MCP server for macOS: Mail, Calendar, Notes, Files, Messages, and more.
Apple Tools (Unified) vs similar servers
| Server | Stars | Type | API key | Runtime |
|---|---|---|---|---|
| Apple Tools (Unified) | 18 | Local | Yes | pypi |
| iCloud MCP | 54 | Local | Yes | npm |
| AIquila — Nextcloud MCP Server | 38 | Hosted | Yes | None |
| Slack | 12 | Local | Yes | npm |
| DocsAgent — Zotero, Obsidian & Apple Notes MCP Server | 623 | Local | Yes | npm |
Questions
It reads 11 environment variables: APPLE_MAIL_MCP_SAFETY_PROFILE, APPLE_CALENDAR_MCP_SAFETY_MODE, APPLE_REMINDERS_MCP_SAFETY_MODE, APPLE_FILES_MCP_SAFETY_MODE, APPLE_FILES_MCP_ALLOWED_ROOTS, APPLE_SYSTEM_MCP_SAFETY_MODE, APPLE_CONTACTS_MCP_SAFETY_MODE, APPLE_NOTES_MCP_SAFETY_MODE, APPLE_MESSAGES_MCP_SAFETY_MODE, APPLE_SHORTCUTS_MCP_SAFETY_MODE, APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT. Set them in your MCP config before starting the server.
Python with uv (runs with uvx) or Claude Desktop (one-click .mcpb bundle), plus an MCP client such as Claude Code, Codex, Claude Desktop or Cursor.
Apple Tools (Unified) is a local MCP server distributed as the pypi package apple-tools-mcp.
Run: claude mcp add apple-tools-mcp -e APPLE_MAIL_MCP_SAFETY_PROFILE=... -e APPLE_CALENDAR_MCP_SAFETY_MODE=... -e APPLE_REMINDERS_MCP_SAFETY_MODE=... -e APPLE_FILES_MCP_SAFETY_MODE=... -e APPLE_FILES_MCP_ALLOWED_ROOTS=... -e APPLE_SYSTEM_MCP_SAFETY_MODE=... -e APPLE_CONTACTS_MCP_SAFETY_MODE=... -e APPLE_NOTES_MCP_SAFETY_MODE=... -e APPLE_MESSAGES_MCP_SAFETY_MODE=... -e APPLE_SHORTCUTS_MCP_SAFETY_MODE=... -e APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT=... -- uvx apple-tools-mcp
Run: codex mcp add apple-tools-mcp --env APPLE_MAIL_MCP_SAFETY_PROFILE=... --env APPLE_CALENDAR_MCP_SAFETY_MODE=... --env APPLE_REMINDERS_MCP_SAFETY_MODE=... --env APPLE_FILES_MCP_SAFETY_MODE=... --env APPLE_FILES_MCP_ALLOWED_ROOTS=... --env APPLE_SYSTEM_MCP_SAFETY_MODE=... --env APPLE_CONTACTS_MCP_SAFETY_MODE=... --env APPLE_NOTES_MCP_SAFETY_MODE=... --env APPLE_MESSAGES_MCP_SAFETY_MODE=... --env APPLE_SHORTCUTS_MCP_SAFETY_MODE=... --env APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT=... -- uvx apple-tools-mcp
Similar MCP servers
NameStars
- iCloud MCPio.github.MrGo2/icloud-mcp54
- AIquila — Nextcloud MCP Serverio.github.elgorro/aiquila-mcp38
- Slackio.github.mindstone/mcp-server-slack12
- DocsAgent — Zotero, Obsidian & Apple Notes MCP Serverio.github.docsagent/docsagent623
- slackcom.pulsemcp/slack80
- Vault Cortexio.github.aliasunder/vault-cortex21
- messagesio.github.cardmagic/messages20
- DBHubio.github.bytebase/dbhub3,574