The mcp-ical server transforms macOS calendar management into a conversational experience using natural language and the Model Context Protocol. It allows users to create events, manage schedules, and check availability easily.
A natural language calendar management tool for macOS, leveraging the Model Context Protocol (MCP) to enable conversational calendar interactions.
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."
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.
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.
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.
Contributions are welcome via forking, creating a feature branch, committing changes, pushing to the branch, and opening a pull request.
Omar-V2/mcp-ical
February 9, 2025
March 28, 2025
Python