# icloud-mcp

icloud-mcp is a Claude Code MCP server that links agents to iCloud Calendar, Contacts, and Mail via CalDAV, CardDAV, and IMAP/SMTP.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7 repo stars
- Author: ThomasCrouzet
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ThomasCrouzet/icloud-mcp
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/thomascrouzet-icloud-mcp

## What it does

The server compiles as a single Go binary running over stdio. It interacts directly with iCloud endpoints through CalDAV for schedules, CardDAV for address books, and IMAP plus SMTP for email handling. Operating entirely without macOS runtime frameworks or browser automation, it functions cleanly in headless environments.

Access is gated by default: only calendar reads are active, registering 7 tools. Up to 24 tools become available when enabling extra capabilities via `ICLOUD_MCP_PERMISSIONS`, `ICLOUD_MCP_ENABLE_CONTACTS`, and `ICLOUD_MCP_ENABLE_MAIL`. Operators can isolate access to specified calendars or mailboxes through `ICLOUD_MCP_RESOURCE_SCOPES`.

Running the server requires an Apple ID with an app-specific password and TLS 1.2+. All enabled services share the same binary memory space, meaning process-level compromise risks loaded credentials.

## Requirements
- Needs: a prebuilt binary from the repository releases

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- search events and find free time slots in iCloud Calendar
- manage schedule entries using direct CalDAV requests
- lookup and update address book entries in vCard 3.0 format
- search inbox messages and send plain-text emails via SMTP

## Example prompts
- Check my iCloud Calendar for free slots tomorrow afternoon.
- Search my iCloud Contacts for the support lead's email.
- List recent unread messages in my iCloud inbox.

## Similar
- [iCloud MCP](https://affpapa.org/en/nevibecode/mcp/icloud-mcp.md) — MCP server · ★ 84 repo stars
- [icloud-calendar-mcp](https://affpapa.org/en/nevibecode/mcp/icloud-calendar-mcp.md) — MCP server · ★ 24 repo stars
- [dav-mcp](https://affpapa.org/en/nevibecode/mcp/dav-mcp.md) — MCP server · ★ 46 repo stars
- [CalDAV MCP Server](https://affpapa.org/en/nevibecode/mcp/caldav-mcp-server.md) — MCP server · ★ 9 repo stars
- [caldav-calendar](https://affpapa.org/en/nevibecode/skills/caldav-calendar.md) — skill · 267 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
