ICloud Calendar

Provides access to view and create iCloud Calendar events via an MCP client using a Python runtime.

python

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "hermanerku-icloud-calendar-mcp-python": {
      "command": "python",
      "args": [
        "/Users/herman/Source/Repos/icloud-calendar-mcp-python/main.py"
      ],
      "env": {
        "ICLOUD_APP_PWD": "YOUR_APP_SPECIFIC_PASSWORD",
        "ICLOUD_APPLE_ID": "YOUR_EMAIL@example.com"
      }
    }
  }
}

This MCP server lets you view and create events in your iCloud Calendar from an external client. It is useful for integrating calendar data into your workflows, automations, or AI-assisted planning tools without leaving your preferred interface.

How to use

You connect to the iCloud Calendar MCP from your MCP client by referencing the local or remote server configuration. Once the server is running, you can list upcoming events, create new events, and interact with your calendar as part of your larger automation or assistant workflow. Start by ensuring your MCP client has the calendar MCP configured and enabled, then issue calendar-related commands through the client’s built-in tool named after the calendar MCP.

How to install

Prerequisites: you need Python installed on your machine. You also need access to iCloud and an app-specific password configured for your iCloud account.

Step 1: Create an environment file with your iCloud credentials.

Step 2: Save your credentials in a .env file in the project root with these variables:

ICLOUD_APPLE_ID="email@example.com"
ICLOUD_APP_PWD="xxxx-xxxx-xxxx-xxxx"

Configuration and start command

The MCP server is run as a local stdio server using Python. The configuration below defines a single MCP server named calendar.

{
  "mcpServers": {
    "calendar": {
      "command": "python",
      "args": [
        "/Users/herman/Source/Repos/icloud-calendar-mcp-python/main.py"
      ]
    }
  }
}

Running and testing locally

After creating the .env file and adding the MCP server configuration, restart your MCP client and ensure the calendar tool is enabled. If your environment differs, adjust the file path in the config to point to your actual main.py.

Additional notes

The setup uses a local Python script to bridge between your iCloud Calendar and your MCP client. Keep your app-specific password secure and rotate it if you suspect it has been exposed.

Available tools

list_events

Fetch and display upcoming events from your iCloud Calendar for review and planning.

add_event

Create a new event in your iCloud Calendar with a specified title, time, and optional location.

Built by

VeilStrat

AI signals for GTM teams