MCP iCal Server

A natural language calendar management tool for macOS, leveraging the Model Context Protocol (MCP) to enable conversational calendar interactions.

Overview

This server transforms macOS calendar management into a conversational experience. Users can interact using natural language, such as "What's my schedule for next week?" or "Add a lunch meeting with Sarah tomorrow at noon."

Features

Key features include event creation with custom calendar selection, location/notes support, smart reminders, and recurring events. It also offers smart schedule management, availability checks, and intelligent event updates, including time/date modifications, calendar transfers, and reminder adjustments. Calendar management features include viewing available calendars and seamless Google Calendar integration via iCloud.

Quick Start

Requires macOS with Calendar app configured, uv package manager, and an MCP client like Claude for Desktop. Installation involves cloning the repository, installing dependencies with uv sync, and configuring Claude with the server path. Claude must be launched from the terminal for calendar permission requests.

Testing

Tests create temporary calendars and events, so run only in development environments. Use uv sync --dev to install dev dependencies and uv run pytest tests to run the test suite.

Contributing

Contributions are welcome via forking, creating a feature branch, committing changes, pushing to the branch, and opening a pull request.