icloud-mcp — Claude Code MCP server: what it does, how to use
icloud-mcp is a Claude Code MCP server that links agents to iCloud Calendar, Contacts, and Mail via CalDAV, CardDAV, and IMAP/SMTP.
MIT ★ 7 updated 2026-11-15
Open on GitHubWhat icloud-mcp does
The server compiles as a single Go binary running over stdio. It interacts directly with iCloud endpoints through CalDAV for schedules, CardDAV for address books, and IMAP plus SMTP for email handling. Operating entirely without macOS runtime frameworks or browser automation, it functions cleanly in headless environments.
Access is gated by default: only calendar reads are active, registering 7 tools. Up to 24 tools become available when enabling extra capabilities via ICLOUD_MCP_PERMISSIONS, ICLOUD_MCP_ENABLE_CONTACTS, and ICLOUD_MCP_ENABLE_MAIL. Operators can isolate access to specified calendars or mailboxes through ICLOUD_MCP_RESOURCE_SCOPES.
Running the server requires an Apple ID with an app-specific password and TLS 1.2+. All enabled services share the same binary memory space, meaning process-level compromise risks loaded credentials.
What it helps with
- search events and find free time slots in iCloud Calendar
- manage schedule entries using direct CalDAV requests
- lookup and update address book entries in vCard 3.0 format
- search inbox messages and send plain-text emails via SMTP
Example prompts for the agent
- Check my iCloud Calendar for free slots tomorrow afternoon.
- Search my iCloud Contacts for the support lead's email.
- List recent unread messages in my iCloud inbox.
How to install icloud-mcp
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about icloud-mcp
How do you connect icloud-mcp to Claude Code?
Configure the compiled Go binary in your MCP client settings over stdio. Provide your Apple credentials and scope environment variables in that configuration.
What can icloud-mcp do without extra permissions?
It starts in read-only mode for calendars, exposing only 7 MCP tools. Write actions, address book lookups, and email features remain disabled until explicitly permitted.
What is required to run icloud-mcp?
You need an Apple Account with an app-specific password, TLS 1.2 or later, and an iCloud Mail address if messaging tools are enabled.