Apple MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Apple MCP
Model Context Protocol server for Apple iCloud. Gives your AI agents access to your Calendar, Reminders, and Mail — filtered through a scope engine so they only see what you want them to see.
Supports stdio and HTTP transport. Works anywhere, not just macOS. 37 tools, zero stubs.
What It Does
Connects your AI tools (Claude Desktop, Continue.dev, Cursor, or any MCP client) to your iCloud account. Three services, each independently toggleable:
Calendar (12 tools) — list, create, update, delete events and calendars. Search by keyword, check availability, recurrence support.
Reminders (15 tools) — full CRUD. Alarms, hashtags, URL attachments, recurrence rules, sync cursors.
Mail (10 tools) — multi-account IMAP. Search, read, send, reply, move, flag, delete emails.
All access is gated through a scope engine. Configure which calendars, reminder lists, mail folders, and mail accounts are visible. Put a service in read-only mode if you only want your agent to see data, not change it.
Related MCP server: icloud-reminders-mcp
Quick Start
Generate an App-Specific Password
You need an app-specific password, not your main Apple Account password.
Go to account.apple.com
Sign in → Sign-In and Security → App-Specific Passwords
Click "Generate an app-specific password"
Name it "Apple MCP" so you know what it's for
Copy the password (format:
xxxx-xxxx-xxxx-xxxx)
You can revoke this password at any time from the same page.
Run with Docker
docker run -p 8080:8080 \
-e APPLE_ID=you@icloud.com \
-e APPLE_APP_SPECIFIC_PASSWORD=xxxx-xxxx-xxxx-xxxx \
ghcr.io/thetaroot/apple-mcp:latestRun with pip
pip install apple-mcp
apple-mcp --transport httpOr stdio transport for local MCP clients:
apple-mcp --transport stdioUsing with Claude Desktop
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"apple": {
"command": "python",
"args": ["-m", "apple_mcp", "--transport", "stdio"],
"env": {
"APPLE_ID": "you@icloud.com",
"APPLE_APP_SPECIFIC_PASSWORD": "xxxx-xxxx-xxxx-xxxx",
"APPLE_CALENDAR_NAMES": "Work",
"APPLE_REMINDER_LISTS": "Work Tasks",
"APPLE_MAIL_MODE": "read_only"
}
}
}
}Using with Cursor or Continue.dev
Point your MCP client to the HTTP endpoint:
{
"mcpServers": {
"apple": {
"url": "http://localhost:8080/mcp",
"headers": {}
}
}
}The HTTP transport uses the standard MCP Streamable HTTP protocol (spec 2025-03-26).
Configuration
All configuration via environment variables.
Authentication (required)
Variable | Description |
| Your iCloud email address |
| App-specific password (shared for all services) |
For better security, use per-service passwords instead:
Variable | Description |
| Password for calendar only |
| Password for reminders only |
| Password for mail only |
Service Toggles
Variable | Default | Description |
|
| Enable calendar tools |
|
| Enable reminder tools |
|
| Enable mail tools |
Calendar Scope
Variable | Description |
| Comma-separated calendar names to allow |
| Comma-separated calendar names to block |
|
|
Reminder Scope
Variable | Description |
| Comma-separated list names to allow |
| Comma-separated list names to block |
|
|
Mail Scope
Variable | Description |
| Comma-separated folder names to allow |
| Comma-separated folder names to block |
|
|
External Mail Accounts
APPLE_MAIL_ACCOUNTS='[
{"type": "icloud", "email": "you@icloud.com", "folders_allow": ["INBOX", "Sent"]},
{"type": "external", "email": "luis@company.com", "imap_host": "mail.company.com",
"imap_port": 993, "smtp_host": "mail.company.com", "smtp_port": 587,
"password_env": "MAIL_PWD_WORK", "folders_allow": ["INBOX", "Sent"]}
]'
MAIL_PWD_WORK=your-external-mail-passwordTools Reference
Calendar — 12 tools
All functional, no stubs. Recurrence support via recurrence parameter (RRULE string). Change tracking via get_changes (ctag-based).
Reminders — 15 tools
All functional, no stubs. Recurrence support: create, list, and delete recurrence rules. Sync cursor support via get_changes.
Mail — 10 tools
All functional, no stubs. Reply support via SMTP with In-Reply-To headers. Full HTML body returned by get.
Health Check
curl http://localhost:8080/health
# {"status":"ok","version":"1.1.0","tools_registered":37}Requirements
Python 3.12 or later
An Apple Account with two-factor authentication enabled
An app-specific password (generated at account.apple.com)
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Let your AI agent read and act on your Mail, Calendar, Contacts and more. Works with iCloud.
Let your agent into iCloud Mail, calendar and contacts. It gets actions, never your password.
Connect Apple iCloud and Microsoft 365 mail, calendars, contacts and tasks to AI.
Connect your email accounts and iCloud Calendar to AI with account-specific permissions.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables users to view and create events in their iCloud Calendar using natural language through supported LLMs. It integrates with Apple's infrastructure via app-specific passwords to provide secure calendar management.1-
- AlicenseAqualityCmaintenanceGives AI agents read and write access to Apple Reminders via iCloud CalDAV, syncing with iPhone/iPad and supporting lists shared via Family Sharing.74MIT
- AlicenseNot gradedqualityDmaintenanceProvides AI calendar operators full iCloud Calendar access through CalDAV, with two-factor authentication and app-specific passwords.MIT
- AlicenseNot gradedqualityDmaintenanceProvides AI assistants with read-only access to iCloud mail and calendar via IMAP and CalDAV, with opt-in write support for sending mail, managing events, and contacts.1MIT