Install iCloud Calendar

Pick your client, copy the command, done.

Manual setup required. The maintainer's config contains paths only you know — edit the placeholders below before adding it to Claude Code.

Run this once before adding it to Claude Code.

git clone https://github.com/HermanErKu/icloud-calendar-mcp-python

claude mcp add -e "ICLOUD_APPLE_ID=${ICLOUD_APPLE_ID}" -e "ICLOUD_APP_PWD=${ICLOUD_APP_PWD}" icloud-calendar -- python /path/to/main.py

Replace any placeholder paths in the command with the real path on your machine.

Required:ICLOUD_APPLE_IDICLOUD_APP_PWD

Environment Variables

Set these before running iCloud Calendar.

VariableDescriptionRequired

ICLOUD_APPLE_IDYour iCloud email addressYes

ICLOUD_APP_PWDApp-specific password generated from account.apple.comYes

Once configured, iCloud Calendar gives your AI agent access to:

list_eventsRetrieve a list of events from the iCloud calendar

create_eventCreate a new event in the iCloud calendar

titlestart_timeend_time

After setup, try these prompts with your AI agent:

→What events do I have scheduled for this Sunday?

→Am I available this coming Tuesday afternoon?

→Create a new calendar event for a team meeting next Friday at 10 AM.

→List all my upcoming events for the rest of the week.

Prerequisites & system requirements

An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
Python 3.8+ with pip installed
ICLOUD_APPLE_ID — Your iCloud email address
ICLOUD_APP_PWD — App-specific password generated from account.apple.com

Save the docs, env vars, and workflow around iCloud Calendar in Conare so Claude Code, Codex, and Cursor remember it next time.