MCP iCal Server
MCP server for the macOS calendar: an agent creates, finds and edits events in natural language
- 333 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Creates, changes and moves events in your personal calendar
- Reads the schedule and contents of macOS calendars
Install
- Works in
Manual install
git clone https://github.com/Omar-V2/mcp-ical.git
cd mcp-ical
uv syncThere is no PyPI package; the server runs from the cloned repository via uv run mcp-ical.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Creates, changes and moves events in your personal calendar
- Reads the schedule and contents of macOS calendars
This is third-party code. Review the repository files before installing.
What it does
The server gives an agent access to the macOS calendar through the Calendar app. From a plain phrase it creates events with location, notes, reminders and recurrence, picks the right calendar, shows a schedule for a period and finds free slots for a meeting. Events can be changed: move the time, switch calendar, update location, notes and reminders. If a Google calendar is synced with iCloud, you can work with Google events through it too.
Who it is for. For macOS users who keep a personal and work schedule in the Calendar app.
Good fit when
- You want to create or move an event with a plain phrase
- You want to see the weekly schedule and find a free slot
- You want to keep recurring meetings with reminders
Not a fit when
- You have no macOS with the Calendar app configured
- You need a server or online calendar not tied to a Mac
Example request
Add a lunch with Sarah tomorrow at noon and remind me an hour beforeMCP
- Transport
- stdio
- Authentication
- not required
Limitations
It works only on macOS with the Calendar app configured. For the system to prompt for calendar access, the client must be launched from the terminal, otherwise access has to be granted manually. It installs from the cloned repository via uv sync and uv run; there is no PyPI package. Per the README, non-standard recurring events are sometimes set imprecisely, and reminders for all-day recurring events may shift by a day.
How to disable. Remove the mcp-ical block from your MCP client config and restart it, optionally delete the repository folder and revoke calendar access in system settings.
FAQ
Why launch the client from the terminal?
Only a terminal launch makes macOS show the calendar access prompt. Launching from Finder does not trigger it, so access must be granted manually.
Can it work with Google Calendar?
Yes, if it is synced with the iCloud calendar. Then you can specify the Google calendar when creating an event.
Discussion
No questions or reviews yet.
Related
MCP serverscaldav-mcp connects an agent to any CalDAV server: calendar lists, events in a time range, plus create, update and delete.
Google Calendar MCP Server: calendar for Claude
Google Calendar MCP Server
A calendar MCP for Claude Desktop: the agent views, creates, updates and deletes Google Calendar events, recurring ones included
iMCP
imcp
A macOS app that opens the calendar, contacts, reminders, messages and other Mac data to AI through MCP. Not affiliated with Apple
Yandex Calendar MCP server
Яндекс Календарь MCP для Claude
An MCP server for Yandex Calendar: view, create and delete events using an app password
An MCP server for mail, calendar, contacts, reminders, notes and Safari: locally through macOS or over iCloud protocols.
Yandex Calendar MCP server over CalDAV
yandex-calendar-mcp
A Yandex Calendar MCP server over CalDAV: reading the schedule, creating and editing events, invitations with real email delivery
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| MCP iCal Server (this card) | no | not required | 333 | |
| applescript-mcp | no | not required | 396 | A macOS MCP server on AppleScript: the agent drives Calendar, Mail, Messages, Notes, Finder, iTerm and Shortcuts |
| Nextcloud MCP Server | no | API key | 411 | connects an agent to Nextcloud |
README in short
The README shows controlling the macOS calendar with plain phrases: creating events with location, notes, reminders and recurrence, viewing the schedule, finding free slots and editing events. Installation is shown via cloning the repository, uv sync and configuring Claude for Desktop with the uv command and the --directory flag. It stresses launching the client from the terminal to gain calendar access. The known issues section notes inaccuracies with non-standard recurrence and reminder shifts. MIT licensed, with calendar integration built on PyObjC.