Skip to content
MCP server

iCloud MCP

Drive Apple Mail, Calendar, Contacts, Reminders, Notes, Messages and Safari from an AI

Runs locallyStatus and history
Install
Pricing
Free
Platforms
macOS, CLI
Runs
Locally
Version
2.2.2
Listing updated
today

Similar MCP servers

About iCloud MCP

iCloud MCP is a free MCP server for productivity. It runs locally on your machine and is started by your AI client.

Two interchangeable backends sit behind 41 tools. In local mode the server drives the native macOS apps through AppleScript, which needs no credentials or network and reaches services the iCloud protocols do not expose: Reminders, Notes, Messages and Safari. In cloud mode it uses IMAP/SMTP, CalDAV and CardDAV with an app-specific password, so it runs on any machine. The set-mode tool switches between them without a restart.

It speaks stdio only and opens no ports. Credentials are read once at startup, never logged, and the README states the server collects no telemetry and keeps no state on disk. Local mode relies on macOS Automation prompts, with Full Disk Access needed to read messages (via the imsg CLI).

Tools declare read-only, destructive and idempotent hints; sending email or messages and the deletions are flagged destructive.

Install

Run in a terminal

claude mcp add icloud-mcp --env ICLOUD_APP_PASSWORD='<ICLOUD_APP_PASSWORD>' -- npx -y mcp-icloud

Add to claude_desktop_config.json

{
  "mcpServers": {
    "icloud-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-icloud"
      ],
      "env": {
        "ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "icloud-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-icloud"
      ],
      "env": {
        "ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "icloud-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-icloud"
      ],
      "env": {
        "ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "icloud-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-icloud"
      ],
      "env": {
        "ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "icloud-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-icloud"
      ],
      "env": {
        "ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • USE_LOCAL_MODEtrue (default) drives the macOS apps via AppleScript; false uses the iCloud protocols
  • ICLOUD_EMAILiCloud address, required only for cloud mode
  • ICLOUD_APP_PASSWORDApp-specific password from appleid.apple.com, required only for cloud mode

Tools this server provides (23)

Taken from the project documentation; the running server may differ.

list-emails
List emails in a folder
read-email
Read one email
send-email
Send an email
search-emails
Search emails
list-events
List calendar events
create-event
Create a calendar event
update-event
Update an event
delete-event
Delete an event
list-contacts
List contacts
search-contacts
Search contacts
create-contact
Create a contact
list-reminders
List reminders
create-reminder
Create a reminder
complete-reminder
Mark a reminder complete
list-notes
List notes
create-note
Create a note
list-chats
List Messages chats
read-messages
Read messages in a chat
send-message
Send a message
list-safari-tabs
List open Safari tabs
open-safari-url
Open a URL in Safari
set-mode
Switch between local and cloud mode
check-auth-status
Verify credentials for the active mode

What it does

Two backends
AppleScript on a Mac, or iCloud protocols anywhere.
Seven Apple services
Email, Calendar, Contacts, Reminders, Notes, Messages and Safari.
Runtime mode switch
Change between local and cloud without restarting.
Typed schemas
Arguments are validated with zod and list tools return structured content.
Behaviour hints
Each tool declares read-only, destructive or idempotent behaviour.
No telemetry
The server collects and stores nothing.

Good for

  • Search email and summarize a thread
  • Create calendar events and reminders by chat
  • Look up a contact's phone number
  • Review the week's Messages chats
  • List open Safari tabs

Pricing

Free

Free npm package

iCloud MCP FAQ

Do I need a password?

Not in local mode. Cloud mode needs your iCloud address and an app-specific password.

Which services only work locally?

Reminders, Notes, Messages and Safari, plus the contact account and group tools.

What does it need to run?

Node.js 20 or newer, launched with npx -y mcp-icloud.

Does it listen on a network port?

No. It communicates over stdin and stdout only.

Is iCloud MCP free?

Yes. iCloud MCP is free to use.

How do I add iCloud MCP to Claude Code?

Run this command in your terminal: claude mcp add icloud-mcp --env ICLOUD_APP_PASSWORD='<ICLOUD_APP_PASSWORD>' -- npx -y mcp-icloud

What are the best alternatives to iCloud MCP?

The closest alternatives to iCloud MCP are TrendRadar, Ha MCP, Concord MCP, Getmitra and note1.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers