Apple MCP Server
hassanzouhar/apple-mcp-server
Acesse Calendar, Reminders, Contacts e Mail via IA no macOS
Ver no GitHubServidor MCP que conecta uma IA aos aplicativos nativos do macOS — Calendário, Lembretes, Contatos e Mail — via JXA (JavaScript for Automation). Executa localmente sem dependências externas, oferecendo 29 ferramentas para automação completa da produtividade pessoal.
Instalação
npx convez-ai hassanzouhar/apple-mcp-server1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automação de agendamentos e consultas de calendário via conversa natural
- Gerenciamento programático de lembretes e listas de tarefas
- Busca e manipulação de contatos integrada com IA
- Composição e envio de mensagens de email controlados por agente
Veredito

Implementação sólida e bem estruturada de MCP para ecossistema Apple. Cobre as aplicações essenciais de produtividade do macOS com granularidade apropriada (29 ferramentas). Adequado para quem precisa integrar IA com fluxos pessoais no macOS; requer Node.js 18+ e perms de segurança.
README
A tradução para o português deste README ainda está na fila.
apple-mcp-server
A Model Context Protocol server that connects an LLM to the four core Apple personal apps on macOS — Calendar, Reminders, Contacts, and Mail — via the JavaScript for Automation (JXA) bridge.
- Transport: stdio (local-only)
- Platform: macOS (Darwin) — this server uses
/usr/bin/osascriptand will refuse to start on any other OS - Stack: Node.js 18+, TypeScript, MCP TypeScript SDK, Zod
- External services: none — everything runs locally against the native macOS apps
Tools (29)
Calendar (7)
| Tool | Description |
|---|---|
apple_list_calendars | Enumerate every calendar (local, iCloud, Google, Exchange…) |
apple_list_events | List events in a date range, optionally filtered by calendar |
apple_search_events | Substring search across summary / location / description |
apple_get_event | Fetch one event by UID |
apple_create_event | Create a new event |
apple_update_event | Patch any subset of event fields |
apple_delete_event | Delete an event |
Reminders (8)
| Tool | Description |
|---|---|
apple_list_reminder_lists | Enumerate every reminders list |
apple_list_reminders | List reminders with filters (list, completed, due-date window) |
apple_search_reminders | Substring search across name / body |
apple_create_reminder | Create a reminder (with optional due date, remind-me, priority, flag) |
apple_update_reminder | Patch reminder fields |
apple_complete_reminder | Toggle the completed flag |
apple_delete_reminder | Delete a reminder |
apple_create_reminder_list | Create a new list |
Contacts (5)
| Tool | Description |
|---|---|
apple_search_contacts | Substring search across name / org / email / phone |
apple_get_contact | Fetch one contact by UID |
apple_create_contact | Create a contact with emails and phones |
apple_update_contact | Patch top-level fields |
apple_delete_contact | Delete a contact |
Mail (9)
| Tool | Description |
|---|---|
apple_list_mail_accounts | Enumerate every Mail.app account |
apple_list_mailboxes | List mailboxes, optionally per account |
apple_list_messages | List recent messages in a mailbox (unread filter, date window) |
apple_search_messages | Substring search across subject / sender |
apple_get_message | Fetch a full message body |
apple_create_draft | Open a draft in Mail.app (NOT sent) |
apple_send_message | Send a message immediately (requires confirm: true) |
apple_mark_message | Mark read / unread |
apple_delete_message | Move to Trash (requires confirm: true) |
Install & build
git clone <this-repo> apple-mcp-server
cd apple-mcp-server
npm install
npm run build
The compiled entry point is dist/index.js.
Run
node /absolute/path/to/apple-mcp-server/dist/index.js
The server speaks MCP over stdio; you normally don't invoke it directly — point your MCP client at it (see below).
Wire it up
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json and add:
{
"mcpServers": {
"apple": {
"command": "node",
"args": ["/absolute/path/to/apple-mcp-server/dist/index.js"]
}
}
}
Restart Claude Desktop. The first time the LLM calls a tool, macOS will prompt you to grant the host process (Claude Desktop) permission to control Calendar / Reminders / Contacts / Mail.
Claude Code / other MCP clients
claude mcp add apple node /absolute/path/to/apple-mcp-server/dist/index.js
macOS permissions
Each of the four apps gates AppleScript access behind a separate System Settings entry. Approve them up front to avoid mid-conversation prompts:
| Need access to | Where to grant |
|---|---|
| Calendar.app | System Settings → Privacy & Security → Automation → enable the host app under "Calendar" |
| Reminders.app | System Settings → Privacy & Security → Reminders → add the host app |
| Contacts.app | System Settings → Privacy & Security → Contacts → add the host app |
| Mail.app | System Settings → Privacy & Security → Automation → enable the host app under "Mail" |
If a tool returns Error: macOS denied access. Grant the host app …, that's the fix.
Design notes
- JXA, not classic AppleScript. Every script is JavaScript — easier to interpolate user data safely and JSON-stringify return values.
- No shell quoting. Scripts are passed to
osascriptover stdin. User input rides in a single argv slot as JSON; the wrapper insiderunJxaparses it back intoINPUT. - Each script is wrapped in a try/catch that returns
{__ok, value | error}so errors surface cleanly as MCP tool errors with actionable hints (we detect the macOS "not authorized" family of errors and translate them). - Per-call timeouts. Mail can be slow on huge mailboxes; it gets a 60 s budget. Everything else uses 30 s.
- whose() is unreliable on some Calendar / Mail collections — we use it where it helps and fall back to in-JS filtering everywhere else.
- Destructive ops are explicit.
apple_send_messageandapple_delete_messageboth requireconfirm: trueto be set by the agent. - All read tools return both Markdown and JSON. Pass
response_format: "json"for programmatic processing.
License
MIT