iCloud MCP Server

io.github.epinethrone/icloud-mcp

Repository Registry

What is the iCloud MCP server?

iCloud Mail, Calendar, Contacts, Reminders, Notes and Drive. Approval-first, self-hosted or local.

How to install iCloud

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

ICLOUD_USERNAME
required
Your Apple Account email.
ICLOUD_APP_PASSWORD
required
secret
An app-specific password from account.apple.com (not your Apple password).
ICLOUD_DISPLAY_NAME
Name shown on mail you send.
DEFAULT_TIMEZONE
IANA timezone for calendar times, e.g. Europe/Berlin.
SEND_REQUIRES_APPROVAL
true: mail Claude sends is saved to Drafts for you to send. false: sent directly.
AGENT_NOTES_FILE
Path to a file with your own rules for agents, added to the instructions.
OWNER_ADDRESSES
Your aliases, comma-separated, so invitations to them count as yours.
WARMUP_ON_START
Sign in to mail, calendar and contacts in the background at start.
TOOL_WORKERS
Tool calls that can run at the same time.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "icloud-mcp": {
      "command": "uvx",
      "args": [
        "icloud-mcp-server",
        "--local"
      ],
      "env": {
        "ICLOUD_USERNAME": "<YOUR_ICLOUD_USERNAME>",
        "ICLOUD_APP_PASSWORD": "<YOUR_ICLOUD_APP_PASSWORD>",
        "ICLOUD_DISPLAY_NAME": "<YOUR_ICLOUD_DISPLAY_NAME>",
        "DEFAULT_TIMEZONE": "<YOUR_DEFAULT_TIMEZONE>",
        "SEND_REQUIRES_APPROVAL": "<YOUR_SEND_REQUIRES_APPROVAL>",
        "AGENT_NOTES_FILE": "<YOUR_AGENT_NOTES_FILE>",
        "OWNER_ADDRESSES": "<YOUR_OWNER_ADDRESSES>",
        "WARMUP_ON_START": "<YOUR_WARMUP_ON_START>",
        "TOOL_WORKERS": "<YOUR_TOOL_WORKERS>"
      }
    }
  }
}