Apple Calendar

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/mgcrea-mcp-apple-calendar

About

Use cases: scheduling

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools

8 read · 3 write · 1 delete

Secrets

None asked for

Install scripts

None found

Runs as

Node.js package

Tools (12)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• apple_calendar_create_event

  Create an event. THIS IS A REAL EVENT ON A REAL CALENDAR: on an iCloud, CalDAV or Exchange calendar it syncs within seconds and there is no draft state and no undo. Check apple_calendar_list_calendars first — writing to one where `isShared` is true is visible to everyone else on that calendar, so prefer a personal one unless the user meant to share it. Read-only calendars are refused. This tool cannot add attendees, which would email a person. The result reports what Calendar actually stored, which is not always what was asked for.

• apple_calendar_delete_events

  Delete whole events. Each result says whether the event ACTUALLY went — Calendar silently declines to delete a repeating event, reporting no error, so `deleted` is decided by re-reading the calendar rather than by the call succeeding. A ref naming ONE occurrence of a repeating event is refused: Calendar's scripting interface cannot remove a single occurrence, and deleting the series instead would take every other one with it. Delete a single occurrence in Calendar.app, or pass the `seriesRef` from get_event to remove the whole series. "All future occurrences" is not offered either — it needs t…

• apple_calendar_diagnosticsread-only

  Report which lanes are live, which macOS permissions are granted, and what each missing one is blocking. Start here when a tool fails or reports nothing — it names the exact System Settings pane to open.

• apple_calendar_find_availabilityread-only

  Find the times nothing is on the calendar, long enough to hold a meeting of a given length. This is the tool for "when am I free", "find me 45 minutes next week" or "what does Thursday look like" — reach for it instead of listing events and looking for gaps yourself, which is where an occurrence of a repeating meeting gets missed. Working hours default to 09:00-18:00 on weekdays, in THIS MACHINE'S timezone, and only time inside them is offered. Slots start on a 15-minute boundary and each one reports how long the whole gap is, which is usually longer than you asked for. Time already past today…

• apple_calendar_get_eventread-only

  Full detail for one event: notes, location, URL, conference link, and whether it has attendees or repeats. A ref naming one occurrence reports that occurrence's times and carries a `seriesRef` pointing at the whole series.

• apple_calendar_list_accountsread-only

  List the accounts Calendar syncs, with how many calendars each holds. Use this to scope a search when the same calendar name exists in more than one account.

• apple_calendar_list_calendarsread-only

  List every calendar with the account it belongs to, whether it is SHARED with other people, and whether it looks writable. Two cautions. `isShared` means anything you write there is visible to the others on it. And `isSubscribed` catches URL-subscribed calendars but not every read-only one — Birthdays and Siri Suggestions are also read-only — so a write can still be refused by Calendar itself.

• apple_calendar_list_eventsread-only

  List events in a date range, earliest first. Occurrences of repeating events are expanded, so a weekly standup appears once per week rather than once. The result carries a `coverage` block naming the window the expansion is known to cover; if your range runs past it, `truncated` is set and says what is missing rather than returning a short list silently. `hasMore` is the other reason a list can be partial: more events matched than `limit` allowed. Returns a `ref` per event for get_event.

• apple_calendar_scheduleSchedule something

  Find a time that genuinely works and put an event on the calendar. Requires writes. Note that this cannot invite anyone — it creates the event only.

• apple_calendar_search_eventsread-only

  Search events by text, most recent first. Unbounded in time unless you give `from` or `to`. Matches each event ONCE at its series start — it does not expand occurrences, so use list_events with a range to see individual instances of a repeating event.

• apple_calendar_update_event

  Change an existing event. On a shared calendar the change is visible to everyone else on it. Note that Apple Events has no transaction: if a change is refused part-way through, earlier fields may already have been written, so the result is the truth about what the event now looks like. Only whole events can be edited: a ref naming ONE occurrence of a repeating event is refused, because Calendar's scripting interface cannot detach a single occurrence and applying the change to the series would move every other one too. To change a single occurrence, delete it with scope "occurrence" and create …

• apple_calendar_whats_my_dayWhat my day looks like

  Read back a day or a range as something you can act on — what is fixed, what is movable, and where the real free time is. Read-only.

Signals

Stars

5

Forks

0

Open issues

2

Weekly downloads

457

Last commit (this folder)

Oct 22, 2026 (8 days ago)

Last release

Oct 25, 2026 (5 days ago)

Last package publish

Oct 22, 2026 (8 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.mgcrea/mcp-apple-calendar

Version

1.31.0

Auth

No auth

Packages

npm @mgcrea/mcp-apple-calendar

License

MIT

Repository

github.com/mgcrea/cupertino

Website

cupertino.mgcrea.io

First seen

Oct 24, 2026

Last checked

Oct 26, 2026

Source

Official MCP Registrygithub-graphql