MCP iCal Server

What is MCP iCal Server?

MCP iCal Server is an MCP (Model Context Protocol) server that enables natural language calendar management for macOS. It converts spoken or typed requests into calendar actions, letting users create, query, update, and manage events with conversational prompts.

How to use MCP iCal Server?

Install prerequisites: uv package manager and an MCP client like Claude for Desktop. Clone the repository, run uv sync, then add the server configuration to claude_desktop_config.json with the command uv --directory /path/to/mcp-ical run mcp-ical. Launch Claude from the terminal (not Finder) to allow calendar permissions, then type natural‑language requests such as “What’s my schedule for next week?”.

Key features of MCP iCal Server

• Natural‑language event creation with location, notes, and reminders
• Schedule queries and availability detection
• Intelligent event updates (time, date, calendar, location)
• Support for recurring events and multi‑calendar management
• Google Calendar integration when synced with iCloud
• Seamless macOS Calendar permission handling

Use cases of MCP iCal Server

• Schedule a team lunch or recurring weekly sync using plain English
• Find free time slots for a meeting on a specific day
• Move, reschedule, or cancel events without manual data entry
• Add detailed notes and reminders to events across multiple calendars
• Query your upcoming schedule for any date range

FAQ from MCP iCal Server

What prerequisites are needed?

macOS with the built‑in Calendar app, the uv package manager, and an MCP‑compatible client (Claude for Desktop is recommended).

How do I grant calendar access?

Calendar permissions must be granted by launching Claude from the terminal (/Applications/Claude.app/Contents/MacOS/Claude). Launching from Finder will not trigger the permission prompt. Manual access can be configured but involves system‑file modifications.

Can I use this server with Google Calendar?

Yes. If your Google Calendar is synced with iCloud Calendar, you can create events in that Google Calendar by specifying the calendar name when issuing a command.

Are there any known issues?

Recurring events with non‑standard schedules may not always be set correctly. Results are better with Claude 3.5 Sonnet than with Haiku. Reminder timing for recurring all‑day events may be off by one day.

How can I test the server?

Install dev dependencies with uv sync --dev and run uv run pytest tests. Test suites create temporary calendars and events, which are cleaned up automatically. Only run tests in development environments.