mcp-ical

mcp-ical

103

The MCP iCal Server is designed to transform macOS calendar management through natural language processing. It allows users to interact with their calendars using conversational queries and commands, and supports features like event creation, schedule management, and intelligent event updates. Seamless integration with Google Calendar is also supported when synced with iCloud.

Overview

Transform how you interact with your macOS calendar using natural language. The mcp-ical server uses the Model Context Protocol (MCP) to create a conversational experience for calendar management.

Features

  • Event Creation: Convert natural language into calendar events with features like custom calendar selection, location, notes, smart reminders, and recurring events.
  • Smart Schedule Management & Availability: Quickly access your schedule and find available times with natural queries.
  • Intelligent Event Updates: Modify events with natural language for time, date, and other changes.
  • Calendar Management: View calendars, get smart suggestions, and integrate seamlessly with Google Calendar via iCloud.

Quick Start

Prerequisites

  • uv package manager
  • macOS with Calendar app
  • An MCP client (e.g., Claude for desktop)

Installation

  1. Clone the repository and install dependencies.
  2. Configure Claude for Desktop with calendar permissions.
  3. Launch Claude for calendar access via the terminal.

Testing

  • Warning: Tests create temporary calendars and events. Only run tests in development environments.

Known Issues

  • Non-standard recurring schedules may not always be set correctly.
  • Better results with Claude 3.5 Sonnet compared to Haiku.
  • Reminder timing for recurring all-day events may be off by one day.

Contributing

Contributions are welcome. Fork, create feature branch, commit, and open a Pull Request.