Skip to main content

Your iCloud Calendar,
for AI agents.

An MCP server that lets your AI assistant check, add, move, and cancel events in iCloud Calendar.

Free and open source. Needs Java 21 or newer.

npx @icloud-calendar-mcp/server

or

uvx icloud-calendar-mcp

Never use your Apple ID password.

The server signs in with an app-specific password. You can revoke it any time without touching your Apple ID.

Create an app-specific password

Ask it like you’d ask a person.

“What’s on my calendar this week?”
Lists your calendars, then reads the week’s events.
“Create a meeting with John tomorrow at 2pm.”
Adds the event, with a reminder if you ask for one.
“Move my 3pm meeting to 4pm.”
Changes the time. Nothing else on the event changes.
“Delete the dentist appointment on Friday.”
For a repeating event, it must say which: this one, this and later, or all.

Five tools. You see what each one can change.​

ToolWhat it doesChanges your calendar
list_calendarsLists your calendars.No
get_eventsReads the events in a date range.No
create_eventAdds an event, all-day or timed, repeating or not.Adds
update_eventChanges an event: one occurrence, this and later, or the whole series.Changes
delete_eventDeletes an event: one occurrence, this and later, or the whole series.Deletes

Also: the calendar://calendars resource, and three prompts you can start from your AI app: schedule_meeting, reschedule, and find_conflicts. Every parameter

Built to be trusted with your calendar.

Runs on any computer

Windows, macOS, or Linux with Java 21. No Mac or Calendar app needed.

Finds events again later

Edit or delete an event in a new session without listing them again.

Repeating events done right

Change one occurrence, this and later, or the whole series.

Never overwrites newer changes

If an event changed somewhere else, the edit stops and says so.

Clear limits

A range that’s too wide returns a clear error, never a cut-off list.

Easy to install

On the MCP Registry, npm, and PyPI.

Set it up in three steps.​

  1. Install Java 21 or newer

    Every option runs the same Java build, npx and uvx included.

  2. Create an app-specific password

    Create one for your Apple ID. Use it here, never your Apple ID password.

  3. Add the server to your AI app

    Put this in your MCP client’s configuration, with your iCloud email address and the new password. In Claude Desktop the file is claude_desktop_config.json: in ~/Library/Application Support/Claude/ on macOS, ~/.config/claude/ on Linux, and %APPDATA%\Claude\ on Windows.

    {
    "mcpServers": {
    "icloud-calendar": {
    "command": "npx",
    "args": [
    "@icloud-calendar-mcp/server"
    ],
    "env": {
    "ICLOUD_USERNAME": "your-apple-id@icloud.com",
    "ICLOUD_PASSWORD": "your-app-specific-password"
    }
    }
    }
    }

    Restart the app and ask: “Show me all my calendars.”

Your calendar goes nowhere else.​

The server talks only to your computer and to iCloud. It sends no telemetry. Your password comes from an environment variable and never shows up in logs or error messages.

  • 282 security tests, covering the OWASP MCP Top 10.
  • Rate limits: 60 reads and 20 writes a minute.
  • Requests to internal addresses are blocked.
  • Every add, change, and delete is logged through the MCP logging protocol.

Security policy and how to report a vulnerability

Stuck?

Sign-in fails

Use an app-specific password, and your full iCloud email address as the user name.

A new event doesn’t show yet

iCloud can take a moment to list a new event. Ask again shortly.

A range is too wide

Ask for a week or a month at a time. One request returns at most 1,000 events.

Something else

See troubleshooting, or open an issue.