# iCloud MCP

> iCloud MCP is a free MCP server for productivity. Drive Apple Mail, Calendar, Contacts, Reminders, Notes, Messages and Safari from an AI. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** macOS, CLI
- **Repository:** https://github.com/mrgo2/icloud-mcp
- **MCP Registry name:** io.github.MrGo2/icloud-mcp
- **Categories:** [productivity](https://ai-powered.com/categories/productivity), [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

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

## Alternatives

- [TrendRadar](https://ai-powered.com/mcp/trendradar): TrendRadar is an open-source MCP server for communication.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [Getmitra](https://ai-powered.com/mcp/getmitra): Getmitra is an MCP server for communication.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Discord](https://ai-powered.com/mcp/discord-2): Discord is a freemium MCP server for communication.
- [InviteKit Calendar Files](https://ai-powered.com/mcp/invitekit-calendar-files): InviteKit Calendar Files is an MCP server for files and documents.
- [Zoom](https://ai-powered.com/mcp/zoom): Zoom is a freemium MCP server for communication.

---
Source: https://ai-powered.com/mcp/icloud-mcp
