icloud-calendar-mcp
Allows AI agents to read and write iCloud Calendar over CalDAV, including listing calendars, listing events with recurring events expanded, and creating, updating, or deleting events.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
icloud-calendar-mcp
A remote MCP server that lets AI agents read and write your iCloud Calendar over CalDAV. It runs on Cloudflare Workers (the free plan is enough), so it works from Claude on the web, desktop, and mobile.
There is no shared public instance. You deploy your own copy to your Cloudflare account, and only you can authorize clients to use it.
Not affiliated with or endorsed by Apple. iCloud is a trademark of Apple Inc.
Tools
Tool | Description |
| Lists calendars that hold events (Reminders lists are excluded) |
| Lists events in a period, with recurring events expanded and times given with their UTC offset |
| Creates a timed or all-day event |
| Changes the title, time, location, or description, keeping alarms, attendees, and recurrence rules |
| Deletes an event |
Related MCP server: Apple Calendar MCP
Requirements
Deploy
Create an app-specific password. Sign in at account.apple.com, open Sign-In and Security → App-Specific Passwords, and generate one. You can revoke it there at any time.
Sign in to Cloudflare. Deployment uses your Wrangler login, so no API token is needed:
bun install bunx wrangler loginConfigure. Copy the example secrets and fill them in.
AUTH_PASSWORDis the password you will type on the consent page when connecting a client; use at least 16 characters.cp .dev.vars.example .dev.varsDeploy. The first deploy uploads the secrets from
.dev.varsand creates the KV namespace for OAuth state:bun run deploy --secrets-file .dev.varsThe server is served at
https://icloud-calendar-mcp.<your-subdomain>.workers.dev/mcp. Yourworkers.devsubdomain is shown on the Workers overview page of the dashboard.
.dev.vars is git-ignored and is also what bun run dev reads; keep it private. Later deploys keep the uploaded secrets and the KV namespace, so they need no flags. To change a secret, run bunx wrangler secret put <NAME>.
To update to a newer version:
git pull
bun install
bun run deployConnect to Claude
Open Settings → Connectors → Add custom connector in Claude, enter your /mcp URL, and keep the detected defaults (sign in now, Claude's public identity). Click Connect, check that the consent page shows claude.ai as a verified client, enter your auth_password, and click Allow.
Connectors added on the web are also available in the Claude mobile apps.
Verify a deployment
scripts/smoke.sh registers a test client, completes the OAuth flow, and calls list_calendars:
AUTH_PASSWORD=... scripts/smoke.sh https://icloud-calendar-mcp.<your-subdomain>.workers.devA PROPFIND ... failed: 401 result means the iCloud credentials are wrong.
How access is protected
MCP clients must complete OAuth 2.1 (with Client ID Metadata Documents or Dynamic Client Registration). Only someone who knows
auth_passwordcan approve a client, and password attempts are rate-limited to 5 per minute.Your iCloud credentials stay in Worker secrets. Tools only accept URLs under your own calendars, so a client cannot redirect the credentials to another host.
Limitations
Reminders are not available over CalDAV and are not supported.
update_eventanddelete_eventact on a recurring event as a whole series; single occurrences cannot be changed or removed on their own.Recurring events that would take too many iterations to expand (for example, a rule repeating every second) are left out of
list_eventsand reported in itsskippedfield.Workers Free allows 10 ms of CPU per request. Expanding a daily event that has repeated for decades can exceed it; the request then fails.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Hosted Google Calendar MCP server for AI agents. No self-hosting or Google Cloud setup.
Connects ChatGPT to your Apple Calendar via a local Mac agent + Vercel relay
Let your AI agent read and act on your Mail, Calendar, Contacts and more. Works with iCloud.
Calendar API for AI agents: events, availability, Google/Microsoft setup, scheduling, and iCal.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables remote MCP clients such as ChatGPT to read and search calendars, fetch events, and perform controlled writes to Apple iCloud calendars through CalDAV, with OAuth and server-enforced write policies.MIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables compatible AI assistants to remotely read and write iCloud calendars, including searching events, checking availability, creating or editing events, responding to invitations, and handling recurring schedules and time zones. It runs headlessly in a Cloudflare account with configurable per-client permissions.13 npmMIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables compatible AI assistants to remotely read and write iCloud calendars through a self-hosted Cloudflare deployment, with configurable permissions, availability search, and event management including recurring events and invitations.MIT
- AlicenseNot gradedqualityNot gradedmaintenanceGives compatible AI assistants remote HTTPS access to a single Apple Account's iCloud calendars, running headlessly in the user's own Cloudflare deployment. Supports read-only or read-write permissions for searching events, checking availability, and creating, editing, deleting, or responding to invitations, including recurring events, time zones, and locations.13 npmMIT