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 passwordAsk it like you’d ask a person.
“What’s on my calendar this week?”
“Create a meeting with John tomorrow at 2pm.”
“Move my 3pm meeting to 4pm.”
“Delete the dentist appointment on Friday.”
Five tools. You see what each one can change.
| Tool | What it does | Changes your calendar |
|---|---|---|
list_calendars | Lists your calendars. | No |
get_events | Reads the events in a date range. | No |
create_event | Adds an event, all-day or timed, repeating or not. | Adds |
update_event | Changes an event: one occurrence, this and later, or the whole series. | Changes |
delete_event | Deletes 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.
Install Java 21 or newer
Every option runs the same Java build, npx and uvx included.
Create an app-specific password
Create one for your Apple ID. Use it here, never your Apple ID password.
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.- npm
- uvx (Python)
- JAR
{"mcpServers": {"icloud-calendar": {"command": "npx","args": ["@icloud-calendar-mcp/server"],"env": {"ICLOUD_USERNAME": "your-apple-id@icloud.com","ICLOUD_PASSWORD": "your-app-specific-password"}}}}{"mcpServers": {"icloud-calendar": {"command": "uvx","args": ["icloud-calendar-mcp"],"env": {"ICLOUD_USERNAME": "your-apple-id@icloud.com","ICLOUD_PASSWORD": "your-app-specific-password"}}}}{"mcpServers": {"icloud-calendar": {"command": "java","args": ["-jar","/path/to/icloud-calendar-mcp-all.jar"],"env": {"ICLOUD_USERNAME": "your-apple-id@icloud.com","ICLOUD_PASSWORD": "your-app-specific-password"}}}}Download
icloud-calendar-mcp-all.jarfrom the latest release.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.
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.
