Apple Ecosystem MCP
abhinavag-svg/apple-ecosystem-mcp
Integração completa do ecossistema Apple para Claude Desktop
Ver no GitHubServidor MCP que expõe Mail, Calendar, Contacts, Reminders, Notes e iCloud Drive do macOS para Claude Desktop. Permite ao Claude raciocinar e agir de forma integrada entre apps do ecossistema Apple, com suporte a tarefas agendadas para workflows recorrentes.
Instalação
npx convez-ai abhinavag-svg/apple-ecosystem-mcp1 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
- Draftar emails consultando contatos, calendário e contexto em paralelo
- Revisar calendário, reminders e mail para preparar briefings diários
- Agendar reuniões encontrando horários livres entre participantes
- Criar tarefas agendadas para triagem diária ou planejamento semanal
- Buscar informações em notas, emails e eventos para compilar resumos
Veredito

MCP server maduro e bem documentado para usuários macOS que querem potencializar Claude com acesso nativo ao ecossistema Apple. Arquitetura inteligente que mistura frameworks nativos, AppleScript e filesystem, com suporte a workflows agendados — ideal para produtividade pessoal integrada.
README
A tradução para o português deste README ainda está na fila.
Apple Ecosystem MCP
Apple Ecosystem MCP is a local macOS MCP server for Claude Desktop and Claude Code. It exposes Mail, Calendar, Contacts, Reminders, Notes, and iCloud Drive through a mix of native macOS frameworks, AppleScript, and local filesystem access.
The project ships primarily as a Claude Desktop .mcpb bundle.
What It Covers
- Calendar
- Contacts
- Reminders
- Notes
- iCloud Drive
- Friendly-name preferences and stable target resolution
- Local scheduled tasks built on top of the same tools
Example Prompts
These are the kinds of things the connector is built for:
Draft an email to Jane J saying we need to plan a meetup night next week in between the kids' schedule. Check her contact details, look at next week's calendar openings, and help me suggest a couple of realistic evenings.Find the latest thread with our school, check my calendar for this week, and draft a reply proposing two pickup-call times that do not conflict with anything.Look up David Chen in my contacts, find our recent email history, check when I'm free next Thursday, and draft a meeting follow-up with a few time options.Review tomorrow's calendar, my overdue reminders, and any unread important mail, then give me a short morning game plan.Find my Tuscany Itinerary note, pull the related calendar events and any travel emails, and help me assemble a clean trip summary.
These are deliberately cross-app. The value is not just one tool at a time, but Claude being able to reason across Mail, Calendar, Contacts, Reminders, Notes, and files together.
Scheduled Workflow Examples
Scheduled tasks are better for recurring read-heavy workflows than one-off commands.
Create a scheduled task that runs every weekday at 7:00 AM and prepares a daily triage summary from my calendar, reminders, and important unread mail.Create a scheduled task for Sunday evening that gives me a weekly planning digest with next week's events, overdue reminders, and open follow-ups.Create a scheduled task for 8:30 PM that generates a tomorrow preview with calendar events, due reminders, and anything I should prepare tonight.List my scheduled tasks and show me which ones are enabled.
Runtime Architecture
- Calendar, Contacts, and Reminders use a bundled native macOS helper.
- Mail uses AppleScript, with an optional local Mail metadata provider for supported date-window and mailbox metadata queries.
- Notes uses AppleScript for canonical reads, with a read-only Apple Notes store fallback for recovery from large-note failures.
- iCloud Drive uses local filesystem access.
More detail lives in docs/architecture.md.
Documentation
If you want the full story of the project, start here:
- docs/README.md
- docs/product-story.md
- docs/development-history.md
- docs/architecture.md
- docs/roadmap.md
Requirements
- macOS 13 or newer
- Claude Desktop or Claude Code
- For local development:
uvand Xcode command line tools /swiftc
Install In Claude Desktop
- Download
apple-ecosystem-mcp.mcpbfrom GitHub Releases. - Double-click the
.mcpbfile and install it in Claude Desktop. - Restart Claude Desktop if needed.
- Grant macOS permissions when prompted.
Local Development
git clone https://github.com/abhinavag-svg/apple-ecosystem-mcp.git
cd apple-ecosystem-mcp
make install
make test
make build
To run directly from a checkout in Claude Desktop:
{
"mcpServers": {
"apple-ecosystem": {
"command": "uv",
"args": ["run", "--project", "/path/to/apple-ecosystem-mcp", "apple-ecosystem-mcp"]
}
}
}
Permissions
The server stays local, but macOS still gates access through TCC permissions.
| Capability | Typical permission |
|---|---|
| Mail tools | Automation -> Mail |
| Notes tools | Automation -> Notes |
| Calendar tools | Calendars |
| Contacts tools | Contacts |
| Reminders tools | Reminders |
| iCloud Drive tools | Full Disk Access may be required |
| Local Mail metadata provider | Full Disk Access may be required |
If a permission is missing, the affected tool should fail with a scoped error rather than taking down the whole server.
Tool Families
The server currently exposes 71 tools across:
- Calendar
- Contacts
- Reminders
- Notes
- iCloud Drive
- Inventory / preferences / target resolution
- Scheduled tasks
To inspect the exact tool set after install, ask Claude to list available tools or call apple_inventory, scheduled_tasks_list, or one of the app-specific list tools.
Scheduled Tasks
Scheduled tasks are local automations layered on top of the same MCP tools. They are intended for report-style and read-heavy workflows first, not background destructive actions.
Examples:
- daily triage
- tomorrow preview
- overdue reminders review
- weekly planning digest
Privacy
- The server runs locally on your Mac.
- It does not host a network service.
- It does not store credentials.
- Data only leaves your Mac when you explicitly use it in Claude.
See PRIVACY.md for the full policy.
Troubleshooting
Common fixes:
- Re-grant macOS permissions in System Settings.
- Restart Claude Desktop after granting new permissions.
- Rebuild the bundle with
make buildif you are testing local changes. - Force legacy provider behavior for Calendar, Contacts, and Reminders with:
APPLE_ECOSYSTEM_MCP_PROVIDER=applescript
- Force Mail to stay on AppleScript:
APPLE_ECOSYSTEM_MCP_MAIL_PROVIDER=applescript
- Force Mail to use the local metadata provider when testing supported queries:
APPLE_ECOSYSTEM_MCP_MAIL_PROVIDER=local
Development Notes
- Main architecture: docs/architecture.md
- Current handoff state: docs/session-state.md
- Release plans and implementation notes: docs/plans
License
MIT. See LICENSE.