Skip to main content
Glama

icloud-mcp-server

A hosted MCP server that lets Claude read, and with your confirmation change, the owner's iCloud Calendar from anywhere: browser, phone, desktop. Say "add dentist Friday 3pm" in a Claude chat and it lands in your calendar after you approve an exact preview. Read-only by default.

Status (2026-11-03): live on Google Cloud Run for one owner, connected to claude.ai. Reads and previewed writes work on the calendars the owner listed. Hardened on the hardening-2026-11 branch (not yet deployed): see docs/reviews/ and docs/FEATURES.md for exactly what is and is not supported.

ChatGPT: the owner uses ChatGPT's native iCloud Calendar and Mail plugins separately. This server no longer ships any ChatGPT-specific setup, callback URLs or roadmap; it serves Claude (generic MCP/OAuth behavior is unchanged).

What it is

  • Single owner. Sign-in goes through a GitHub OAuth App and only the owner's numeric GitHub ID is accepted (SECURITY.md).

  • CalDAV to iCloud with an app-specific password kept in Secret Manager. That password cannot be limited to calendar only; read the blast-radius section of docs/DESIGN.md.

  • Preview, then confirm. preview_create_event, preview_update_event and preview_delete_event write nothing and return an exact preview with a one-time token and an operation_id. confirm_change is the only tool that writes; it answers applied, not_applied or unknown and never silently retries.

  • Untrusted text is labelled (untrusted fields, a notice on every result). This reduces prompt-injection risk; it does not remove it.

Related MCP server: icloud-mcp

Not built

A local EventKit mode is not built: helper/ is a placeholder and spike/ only tests macOS Calendar permission. There is no iCloud Mail module (design notes only: docs/MAIL.md), no invitations or RSVP, and this is not full Google Calendar parity.

Develop

uv sync
uv run pytest                                   # offline: fakes plus a local Radicale CalDAV server
uv run ruff check . --extend-ignore EXE002      # EXE002 is exFAT noise on the owner's SSD; CI runs plain `ruff check .`
uv run mypy

Real-iCloud tests are opt-in and touch only a calendar named exactly TEST (docs/TESTING.md).

Docs

License

MIT. Depends on recurring-ical-events (LGPL-3.0) as an unmodified library; see docs/DESIGN.md.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides AI assistants with read-only access to iCloud mail and calendar via IMAP and CalDAV, with opt-in write support for sending mail, managing events, and contacts.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables an AI assistant to read and search iCloud mail, draft messages (never sent), manage calendar events with a preview/commit gate, and look up contacts via IMAP, CalDAV, and CardDAV.
      243 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables Claude and other MCP clients to read, search, and plan events across every calendar account on a Mac, including finding free time, preparing meetings, and creating or moving events, with deletes and changes to shared events requiring user approval. All data stays local via EventKit, and every change can be undone.
      MIT