home / mcp / mcp ical mcp server

MCP iCal MCP Server

A Model Context Protocol Server that allows you to interact with your MacOS Calendar through natural language.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "omar-v2-mcp-ical": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-ical",
        "run",
        "mcp-ical"
      ],
      "env": {
        "ENV_SAMPLE": "PLACEHOLDER"
      }
    }
  }
}

You can manage your macOS calendar with natural language through a dedicated MCP server that integrates Calendar access and multi-calendar management. This server lets you create, update, and query events using simple conversational commands, while handling permissions and syncing with supported calendars.

How to use

You interact with the MCP iCal Server using a compatible MCP client. Start the server locally, then issue natural language requests such as asking what’s on your calendar, adding events to a specific calendar, or updating existing events. The server supports creating events with optional locations, notes, reminders, and recurring patterns, as well as checking availability and suggesting open time slots. You can target specific calendars (e.g., Personal, Work, Engineering) and rely on Google Calendar when it is synced with iCloud for cross-calendar creation.

Typical usage patterns include: creating events through natural language, querying upcoming schedules, and updating details like time, location, notes, or reminders. When you phrase a request, Claude or another MCP client will translate it into calendar actions and provide a clear confirmation, such as the event name, date, and location. If you have multiple calendars configured, specify the desired calendar during event creation or updates to ensure the event lands in the right place.

How to install

Prerequisites you need before installation:

uv package manager
macOS with Calendar app configured
An MCP client (Claude for Desktop is commonly used)

Step-by-step setup and run flow

# 1. Clone and set up the MCP iCal server
git clone https://github.com/Omar-V2/mcp-ical.git
cd mcp-ical

# 2. Install dependencies (UV package manager handles this project)
uv sync

Additional sections

Configuration and runtime details are provided here to help you run the MCP iCal Server smoothly.

Claude integration configuration (local runtime) is used to connect the MCP server to the desktop Claude client. The server runs as a local process invoked by the client, and the client must be started from the terminal to prompt calendar permissions correctly.

Start and test flow: after starting Claude from the terminal, you can issue calendar-related commands to verify that the server creates and updates events as requested.

Testing and reliability notes: the server supports event creation, updates, and smart schedule management. Be aware of potential quirks with non-standard recurring events and reminder timing for all-day events, and adjust expectations accordingly.