iCloud MCP
Drive Apple Mail, Calendar, Contacts, Reminders, Notes, Messages and Safari from an AI
- 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-icloudAdd 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 protocolsICLOUD_EMAILiCloud address, required only for cloud modeICLOUD_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.

