icloud-calendar-mcp 1.0.1

MCP server for iCloud Calendar access via CalDAV

iCloud Calendar MCP Server

A security-first MCP (Model Context Protocol) server for iCloud Calendar access via CalDAV.

Installation

# Using uvx (recommended)
uvx icloud-calendar-mcp

# Using pip
pip install icloud-calendar-mcp
icloud-calendar-mcp

Requirements

• Java 17+ must be installed
• iCloud credentials (Apple ID + App-Specific Password)

Setup

1. Get an App-Specific Password

1. Go to appleid.apple.com
2. Sign in and go to Security → App-Specific Passwords
3. Generate a new password for "iCloud Calendar MCP"

2. Set Environment Variables

export ICLOUD_USERNAME="[e-mail]"
export ICLOUD_PASSWORD="your-app-specific-password"

3. Configure Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "icloud-calendar": {
      "command": "uvx",
      "args": ["icloud-calendar-mcp"],
      "env": {
        "ICLOUD_USERNAME": "[e-mail]",
        "ICLOUD_PASSWORD": "your-app-specific-password"
      }
    }
  }
}

Available Tools

Tool	Description
list_calendars	List all available calendars
get_events	Get events from a calendar
create_event	Create a new calendar event
update_event	Update an existing event
delete_event	Delete an event

Security

• Uses App-Specific Passwords (never your main Apple ID password)
• Credentials are only used for CalDAV authentication
• No data is stored or transmitted to third parties

Links

• GitHub Repository
• npm Package
• MCP Documentation

License

Apache-2.0