MrGo2/icloud-mcp

Overview

MCP server for Apple services including Mail, Calendar, Contacts, Reminders, Notes, Messages, and Safari. It connects to AppleScript locally or to iCloud via IMAP, CalDAV, and CardDAV protocols.

Best for

Best for
Developers building MCP servers that integrate Apple apps

Use cases

• Read and manage Mail messages through MCP
• Sync Calendar events and reminders with CalDAV
• Access Contacts and Notes from Apple hooks

How to use

Install

claude mcp add --transport stdio icloud -- npx -y mcp-icloud

Tools exposed

• USE_LOCAL_MODE
• ICLOUD_EMAIL
• ICLOUD_APP_PASSWORD
• ICLOUD_MCP_IMSG_PATH

Tested with

Claude Desktop, Claude Code, Cursor, VS Code, ChatGPT

Example client config

{\n  "mcpServers": {\n    "icloud": {\n      "command": "npx",\n      "args": ["-y", "mcp-icloud"]\n    }\n  }\n}

Notes

MCP server for Apple services including Mail, Calendar, Contacts, Reminders, Notes, Messages, and Safari. It connects to AppleScript locally or to iCloud via IMAP, CalDAV, and CardDAV protocols.

49 stars on GitHub. Last updated 2026-08-11. Licensed MIT.

Use cases

• Read and manage Mail messages through MCP
• Sync Calendar events and reminders with CalDAV
• Access Contacts and Notes from Apple hooks

Pros

• Covers multiple Apple services in one server
• Supports both local AppleScript and iCloud remote
• Written in JavaScript for easy integration

Cons

• Small community with 49 stars
• Requires AppleScript or iCloud credentials
• No vendor and community maintained

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.