Integrates with iCloud Calendar via CalDAV, allowing read access by default and optional confirmed writes such as creating, updating, and deleting individual events. Planned iCloud Mail support is read and drafts only: search and read mail, and create drafts, without sending, deleting, or moving mail.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@icloud-mcp-server add dentist appointment Friday at 3pm"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP server that lets Claude and ChatGPT use your iCloud Calendar (and, later, iCloud Mail), from anywhere: browser, phone, desktop. Say "add dentist Friday 3pm" in a Claude chat and it lands in your iCloud calendar. ChatGPT can read the calendar; on a Plus/Pro plan it very likely cannot add events (OpenAI limits those plans' custom connectors to read and fetch; see docs/DESIGN.md §9). Read-only by default. Any change is shown to you as an exact preview and applied only after you confirm.
Status (2026-10-21): the read-only hosted server is built and tested with fakes and a local CalDAV server; it has not yet been run against real iCloud, GitHub, Claude or ChatGPT. Calendar writes and iCloud Mail are not built yet. To try it, follow docs/RUNBOOK-CLOUDRUN.md.
iPhone: Claude's iOS app already reads your calendar and creates events through the system Calendar (all plans; Anthropic's help article, Aug 2026). Try that first.
Claude in the browser and ChatGPT: these call your server from their own clouds, so it must be a public HTTPS server with OAuth. That is what this project builds (Anthropic, OpenAI).
Related MCP server: Apple MCP
HOSTED (built first) | LOCAL (optional, later) | |
For | browser Claude, ChatGPT, Claude iPhone via connector | Claude Desktop, Claude Code on your Mac |
How | HTTPS server + CalDAV + OAuth | stdio server + Swift EventKit helper |
Credential | iCloud app-specific password on the server | None (macOS permission) |
Calendars | iCloud only | everything on the Mac |
Cost | aiming for $0 on Google Cloud Run's free tier (needs a billing account; some quotas UNVERIFIED); Fly.io is the paid fallback at about $2.19/month | $0 |
Setup time | about 30 minutes | about 15 minutes with Xcode Command Line Tools |
Guides: Cloud Run runbook (free) · Fly.io runbook · HOSTED overview · LOCAL
v1 is read + drafts only: search and read mail, and create drafts in your Drafts folder. It never sends, deletes or moves mail. Mail is the main prompt-injection risk, so it is a separate opt-in module that ships after calendar works. Design: docs/MAIL.md.
Writes are off unless the server starts with --allow-writes, and only for calendars you list.
preview_create_event, preview_update_event, preview_delete_event and create_draft only return a preview and a one-time token. confirm_change is the only tool that writes, and it re-reads afterwards to verify.
Deletes are one event (or one occurrence) at a time. There is no bulk delete.
Event and mail text is returned labelled as untrusted data, to reduce prompt-injection risk. This reduces the risk; it does not remove it.
Read SECURITY.md before running hosted mode: the app-specific password also opens iCloud Mail and Contacts.
docs/DESIGN.md: architecture, trade-offs, blast radius
docs/TOOLS.md: calendar tools with schemas and examples
docs/MAIL.md: mail module design
docs/TESTING.md: test plan
spike/: 5-minute macOS permission test (LOCAL mode)
MIT. Hosted mode depends on recurring-ical-events (LGPL-3.0) as an unmodified library; see docs/DESIGN.md.
This server cannot be deployed
Mac & Windows: let ChatGPT, Claude & Cursor use your email, calendar, iMessage, Teams, files.
Connect Apple iCloud and Microsoft 365 mail, calendars, contacts and tasks to AI.
Your mailboxes in ChatGPT and Claude: Gmail, iCloud, Fastmail, any IMAP. Passwords stay yours.
Create and update subscription calendars from ChatGPT, Claude, or Codex.
