Skip to content
MCP server

Icloud Calendar MCP

CalDAV access to Apple iCloud calendars with durable event handles and recurrence support

Runs locally
Install

Icloud Calendar MCP is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
3.3.0
Listing updated

Similar MCP servers

Install

Run in a terminal

claude mcp add icloud-calendar-mcp --env ICLOUD_USERNAME='<ICLOUD_USERNAME>' --env ICLOUD_PASSWORD='<ICLOUD_PASSWORD>' -- npx -y @icloud-calendar-mcp/server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "icloud-calendar-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@icloud-calendar-mcp/server"
      ],
      "env": {
        "ICLOUD_USERNAME": "<ICLOUD_USERNAME>",
        "ICLOUD_PASSWORD": "<ICLOUD_PASSWORD>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "icloud-calendar-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@icloud-calendar-mcp/server"
      ],
      "env": {
        "ICLOUD_USERNAME": "<ICLOUD_USERNAME>",
        "ICLOUD_PASSWORD": "<ICLOUD_PASSWORD>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "icloud-calendar-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@icloud-calendar-mcp/server"
      ],
      "env": {
        "ICLOUD_USERNAME": "<ICLOUD_USERNAME>",
        "ICLOUD_PASSWORD": "<ICLOUD_PASSWORD>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "icloud-calendar-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@icloud-calendar-mcp/server"
      ],
      "env": {
        "ICLOUD_USERNAME": "<ICLOUD_USERNAME>",
        "ICLOUD_PASSWORD": "<ICLOUD_PASSWORD>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "icloud-calendar-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@icloud-calendar-mcp/server"
      ],
      "env": {
        "ICLOUD_USERNAME": "<ICLOUD_USERNAME>",
        "ICLOUD_PASSWORD": "<ICLOUD_PASSWORD>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • ICLOUD_USERNAMEYour Apple ID email (e.g., user@icloud.com)Required
  • ICLOUD_PASSWORDApp-specific password for iCloud (not your main Apple ID password)Required

About Icloud Calendar MCP

Unlike macOS-only calendar bridges, this one talks CalDAV directly and runs wherever Java 21 or newer is installed, even when launched through npx or uvx, since those only download and start the JAR. It needs your Apple ID email and an app-specific password, which the README says should never be your main password.

Five tools list calendars, fetch events in a date range, and create, update and delete events. Event results carry an opaque handle that survives restarts, so an edit or delete needs no re-listing. Recurring series expand into one result per occurrence, and you can change a single occurrence, this-and-future, or the whole series. Date ranges are capped at 366 days and 1000 events, returning a structured error rather than a truncated answer. Dates are interpreted as UTC days.

Three prompt templates handle scheduling a meeting, rescheduling and finding conflicts. Rate limits are 60 reads and 20 writes a minute, and the project cites 282 tests aligned with the OWASP MCP Top 10. iCloud may lag briefly before a new event appears in listings.

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

list_calendars
List all calendars from the iCloud account
get_events
Get events within a date range from a calendar
create_event
Create a new calendar event
update_event
Update an event, whole series or a single occurrence
delete_event
Delete an event, whole series or a single occurrence

What it does

Durable event handles
Reference events across sessions without re-listing.
Recurrence editing
Change one occurrence, this-and-future, or a whole series.
Bounded responses
Caps return a clear error instead of truncated data.
Prompt templates
Schedule, reschedule and find conflicts.
Rate limiting
60 reads and 20 writes per minute.
Several install routes
Run via npx, uvx or a standalone JAR.

Good for

  • Ask what is on your calendar this week
  • Create a meeting with a colleague tomorrow at 2pm
  • Move a 3pm meeting to 4pm
  • Find overlapping events on a given day
  • Delete a single occurrence of a repeating event

Pricing

Open source

Free and open source; needs an iCloud account

Icloud Calendar MCP FAQ

What credentials does Icloud Calendar MCP need?

An Apple ID email and an app-specific password, not your main Apple ID password.

What does Icloud Calendar MCP require to run?

Java 21 or newer on your PATH, including when using npx or uvx.

Which tools are available?

list_calendars, get_events, create_event, update_event and delete_event.

Why might a new event be missing?

iCloud does not guarantee instant visibility, so a just-created event can be absent from the next listing briefly.

Is Icloud Calendar MCP free?

Yes. Icloud Calendar MCP is open source, so you can use and self-host it for free.

How do I add Icloud Calendar MCP to Claude Code?

Run this command in your terminal: claude mcp add icloud-calendar-mcp --env ICLOUD_USERNAME='<ICLOUD_USERNAME>' --env ICLOUD_PASSWORD='<ICLOUD_PASSWORD>' -- npx -y @icloud-calendar-mcp/server

What are the best alternatives to Icloud Calendar MCP?

The closest alternatives to Icloud Calendar MCP are icloud-mcp, Apple Calendar, Apple Calendar, Pim MCP and iCloud MCP.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers