Skip to main content
MCP server CX Codex

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 GitHub

What 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.

Similar MCP servers

All MCP servers for Notes, tasks and projects →

Project sponsors

Companies that keep this analytics open