Log inSubmit server
Apple Calendar logo

Apple Calendar

Searches Apple Calendar by date range, finds free time, and supports gated calendar writes through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Apple Calendar

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "apple-calendar-2": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-mail"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

The install command didn't complete successfully in our automated test.

npx -y @mgcrea/mcp-apple-mail

f npm available! 10.1.0 -> 12.2.1 npm notice Changelog: <https://github.com/npm/cli/releases/tag/v12.2.1> npm notice Run `npm install -g npm@12.2.1` to update! npm notice npm ERR! code EBADPLATFORM npm ERR! notsup Unsupported platform for @mgcrea/mcp-apple-mail@1.30.0: wanted {"os":"darwin"} (current: {"os":"linux"}) npm ERR! notsup Valid os: darwin npm ERR! notsup Actual os: linux npm ERR! A complete log of this run can be found in: /home/user/.npm/_logs/2026-10-22T11_55_16_897Z-debug-0.log

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1d ago.

Overview

The Apple Calendar MCP server exposes Apple Calendar data and actions to MCP-compatible agents on macOS. It supports date-range queries, calendar search, free-time lookup, and calendar writes that remain disabled unless explicitly enabled. Run it through npm, from source, or through the signed Cupertino app when you want a shared permission boundary. Reach for it when an agent needs to inspect schedules or coordinate calendar changes using the calendars already configured on a Mac.

Use cases

  • Search calendar events within a date range
  • Find available time before scheduling
  • Review existing commitments for an agent workflow
  • Enable guarded calendar writes when changes are required

Key features

  • Date-range calendar queries
  • Calendar search
  • Free-time lookup
  • Gated calendar writes
  • 10 MCP tools

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

6/6 checks healthy over the last 40d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 13d ago via OSV.dev · @mgcrea/mcp-apple-mail (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars5Stargazers on the source repository.
npm downloads1.3kPackage downloads in the last 30 days.
Last commit5d agoMost recent push to the default branch.
Install checkInconclusiveInstall command did not finish in our automated test.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Apple Calendar works

What Apple Calendar does

The Apple Calendar MCP server connects an MCP-compatible agent to the Calendar app already configured on a Mac. It provides calendar operations for inspecting events across date ranges, searching calendar data, and locating available time. The Calendar surface contains 10 tools and also includes write capabilities, although those mutating tools are disabled by default.

This package is one surface in the Cupertino project, which provides separate MCP servers for several Apple apps. Loading the Calendar surface independently lets a host expose only the calendar tools needed by an agent rather than the full set of Apple app integrations.

How it works

The server brokers access to Apple Calendar through the app's scripting interface and the shared Cupertino core. An MCP host starts the server, and the server translates agent requests into calendar operations on the Mac. The repository describes shared handling for the Apple-event boundary, TCC-aware errors, and a read-only SQLite component.

Calendar writes are controlled per surface. When writes are disabled, the mutating tools are not registered with the MCP host, so an agent cannot discover or invoke them. Enabling writes makes those tools available and allows the agent to perform supported calendar changes.

Setup and configuration

The npm package can be launched with npx, or the project can be built from source and started using the Calendar package's compiled CLI. A source installation requires cloning the repository, running pnpm install, and running pnpm build; the host can then be configured with an absolute path to packages/calendar/dist/cli.js.

The repository also provides a signed Cupertino app that can broker the servers through one application-level permission grant. Install it with Homebrew using the project's cask, then configure the host to use the app's bridge when that permission model is preferred. Running the package directly instead grants the required macOS permission to the process that launches it, such as an editor or terminal.

The Apple Calendar MCP server requires macOS Calendar access and does not require a license key. Writes must be enabled explicitly according to the project's configuration process; the default is read-only operation.

Tools and capabilities

The Calendar surface supports:

  • Querying events over date ranges
  • Searching calendar data
  • Looking up free time
  • Performing calendar writes when the write gate is enabled
  • Exposing 10 Calendar-focused MCP tools through its own server

These capabilities suit agents that need schedule context, such as checking commitments before drafting a plan or finding open time for a proposed meeting.

Limitations and notes

The Apple Calendar MCP server is unofficial and is not affiliated with Apple. It operates on the calendars available through Apple Calendar on the local Mac, rather than providing a standalone hosted calendar service.

Permission behavior depends on how the server is launched. Direct npm execution assigns macOS access to the launching host process, while the signed Cupertino app is designed to hold one Full Disk Access grant for its bridged surfaces. The server should therefore be configured with the permission model appropriate to the deployment.

Calendar writes are not available by default. Agents that need only schedule inspection can leave the write gate closed, while workflows that change calendar data must enable it deliberately.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Apple Calendar

Apple Calendar is an MCP server that connects agents to the Calendar app on a Mac. Its main tools support date-range queries, calendar search, free-time lookup, and calendar writes. Write tools are disabled by default and become available only when the Calendar surface's write gate is enabled.

Install it through the repository's npm package with npx, or build the repository from source and point your MCP host to the compiled Calendar CLI. The project also offers a signed Cupertino app installable through Homebrew for bridged permission handling.

Yes, it supports calendar writes when the write gate is enabled. Writes are disabled by default, and the mutating tools are not registered while the gate is closed.

Yes, the repository documents Claude Code as an MCP host option. Configure the Calendar server in the host's MCP configuration and choose either direct package execution or the Cupertino app bridge for permission handling.

Related MCP servers

All in Workplace & Productivity All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewApple Calendar AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/apple-calendar-2?style=directory)](https://allmcps.com/mcp/apple-calendar-2)
HTML Embed
<a href="https://allmcps.com/mcp/apple-calendar-2"><img src="https://allmcps.com/api/badge/apple-calendar-2?style=directory" alt="Apple Calendar on AllMCPs" /></a>