MCP.Market

Apple Calendar MCP server

by redpop·io.github.redpop/apple-calendar-mcp·v0.2.1
No reviews yet

Read and create Apple Calendar events on macOS, and find free time across calendars.

A88/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A88/100

full report

Adoption
New

0 stars51 downloads/wk

Reviews

Write one

Nobody has reviewed Apple Calendar yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Apple Calendar tools (6, 3 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • create_eventwrite action

    Creates a new event. Without calendarId the default calendar is used. Read-only calendars are rejected. For all-day events, alarms are floored to whole days and placed at 09:00, matching Calendar.app. Never modifies or deletes existing events — neither is currently possible.

  • delete_eventwrite action

    Deletes an event. Get eventIdentifier from list_events. For a recurring event, also pass occurrenceDate to name the instance and span to say how far the deletion reaches — this removes only that occurrence, future removes it and every later one. There is no undo, and span is not optional for recurring events for that reason. Read-only calendars are rejected. Returns the event as it was before dele

  • find_free_time

    Finds free slots of at least durationMinutes. activityDomain controls days and hours together: work means Mon-Fri 09:00-18:00, personal every day at the same hours, unrestricted every day around the clock. workingHours overrides only the hours. bufferMinutes keeps time free around each busy event, so a slot wedged between two meetings is not offered as usable. Returns the free gaps, not the busy e

  • list_calendars

    Lists every calendar configured in macOS Calendar, including iCloud ones. Returns id, title, type, source, color and allowsModifications for each. Does not read events — list_events does that.

  • list_events

    Reads events in a date range. Recurring events are returned as individual occurrences. All-day events additionally carry startDay and endDay as plain dates, where endDay means the last day included. Changes nothing. For free gaps rather than busy events, use find_free_time.

  • update_eventwrite action

    Changes an existing event. Only the fields you pass are changed; anything left out keeps its current value. Get eventIdentifier from list_events. For a recurring event, also pass occurrenceDate to name the instance and span to say how far the change reaches — this affects only that occurrence, future affects it and every later one. Read-only calendars are rejected. Alarms, if given, replace all ex

Public scan report

scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it

no findings
  • Code scan17 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 53 days ago12/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 88/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Apple Calendar compares

Against every graded Productivity MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
88/100
higher than 75% of 1,297 Productivity servers
Tools
6
the typical Productivity server has 7
Tools that change things
50%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
51
more than 41% of 423 Productivity servers with a package

What its tools let an agent do: 3 read · 1 create · 1 change · 1 delete

Install Apple Calendar in Claude Code, Cursor or VS Code

Runs npx -y @redpop/apple-calendar-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add apple-calendar-mcp -- npx -y @redpop/apple-calendar-mcp
Add to Cursor

What the publisher says

From the Apple Calendar repository's README, as published. We do not edit it. Read it on GitHub

apple-calendar-mcp

An MCP server that lets an AI assistant read and create events in Apple Calendar — and work out when you actually have time.

macOS only. It talks to EventKit, Apple's own calendar framework, which has no cross-platform equivalent.

claude mcp add apple-calendar -- npx -y @redpop/apple-calendar-mcp

No Xcode, no Swift toolchain, no repository clone. The signed helper binary ships inside the package.

What it does

Most calendar integrations answer what is on my calendar. This one also answers when am I free:

"Find me two hours for deep work this week, outside meetings"
"When could I fit a 30-minute call with someone in Berlin?"
"Book focus time Thursday morning"

findfreetime returns the open gaps, not the busy blocks. It understands that "work" means weekdays during working hours, that "personal" means any day, and that all-day events usually shouldn't count as busy.

It can also keep a buffer around each meeting, because a gap wedged directly between two calls is free on paper and useless in practice.

Alongside that, the usual: list calendars, read events in a range with optional text search, create, update and delete events with location, notes, alarms, all-day or timed. Recurring events come back as individual occurrences, not as the master event — a detail AppleScript-based servers routinely get wrong.

Changing or deleting an occurrence of a recurring event requires saying explicitly whether you mean just that one or every later one too. There is no default for that, because "cancel this Tuesday" and "never again" are not the kind of thing to guess at.

Full parameter reference: docs/tools.md.

Requirements

  • macOS 14 (Sonoma) or newer
  • Node.js 20 or newer

Nothing else. Building from source additionally needs Xcode Command Line Tools, but installing from npm does not.

Setup

1. Add the server to your client.

Claude Code

claude mcp add apple-calendar -- npx -y @redpop/apple-calendar-mcp

Claude Desktop

Quit Claude Desktop first (Cmd+Q) — it rewrites its config on exit, so editing while it runs discards your change. Then add to ~/Library/Application Support/Claude/claudedesktopconfig.json:

{
  "mcpServers": {
    "apple-calendar": {
      "command": "npx",
      "args": ["-y", "@redpop/apple-calendar-mcp"]
    }
  }
}

Cursor, Windsurf, Zed and other MCP clients

Any client that speaks MCP over stdio works. The command is npx, the arguments are -y @redpop/apple-calendar-mcp, and no environment variables are needed.

2. Grant calendar access on first use.

Ask your assistant "what calendars do I have?". A system dialog appears asking to let calendar-helper — not your assistant, the helper itself — access your calendar.

Confirm it, then open System Settings → Privacy & Security → Calendars → calendar-helper → Options… and make sure Full Access is selected, not "Add Only". Read-only access is not enough; the helper checks for full access at startup.

This one dialog is the only manual step, and no package format can take it away. It appears once and survives updates.

Why the dialog says "calendar-helper"

macOS grants calendar permission to the responsible parent process, not to the program actually asking. An AI client that declares no calendar usage in its bundle therefore locks out everything it starts — silently, with no dialog and no entry in System Settings. Several MCP calendar servers work around this by telling you to launch your client from a terminal.

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Apple Calendar: common questions

Is Apple Calendar MCP server safe?
Yes, by our scan: it is graded A (88/100). Read the Apple Calendar safety report
How do I install Apple Calendar?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Apple Calendar need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Apple Calendar maintained?
The last commit was 92 days ago (2026-08-02). The latest release is v0.2.1.
What can I use instead of Apple Calendar?
Servers from other publishers that do the same job: Apple Tools (Unified) MCP server, Agent-Native Calendar MCP server and DocsAgent — Zotero, Obsidian & Apple Notes MCP Server.
How does Apple Calendar compare with other Productivity MCP servers?
safety score 88/100 (higher than 75% of 1,297 Productivity servers); tools 6 (the typical Productivity server has 7); tools that change things 50% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Apple Calendar

Same job from other publishers: the closest match first, then the best rated.