Apple Calendar

MCP server for Apple Calendar on macOS.

Provides access to calendars and events through EventKit. Keep Calendar as the system of record while enabling agents to read, create, update, and delete events.

When to use

  • Calendar-only workflows
  • EventKit-backed calendar access without the all-in-one server
  • Tighter app-level separation for scheduling

What It Does

  • Discover and list calendars
  • Create, read, update, and delete events
  • Tool discovery helpers search_tools and get_tool_info for context-constrained clients
  • Today resources and planning prompts
  • Health checks that distinguish empty results from blocked access
  • Read fallback through Calendar.app automation when native EventKit reads are blocked on supported local setups
  • Permission recovery: calendar_permission_guide, calendar_recheck_permissions

Install On This Mac

Quick start (uvx, from PyPI)

With uv installed:

uvx apple-calendar-mcp

No clone, no venv management.

From a clone 
git clone https://github.com/JonathanRReed/Apple-MCPs.git
cd Apple-MCPs
uv sync --all-packages

This builds one workspace environment with every server's entry point in .venv/bin (for example .venv/bin/apple-calendar-mcp). You can also point an MCP client at Apple-Calendar-MCP/start.sh, which prefers uv run and falls back to a plain venv bootstrap (Python 3.11+ required).

Install In AI Agents

Generic MCP client config 
{
  "mcpServers": {
    "apple-calendar": {
      "command": "uvx",
      "args": ["apple-calendar-mcp"],
      "env": {
        "APPLE_CALENDAR_MCP_SAFETY_MODE": "safe_manage"
      }
    }
  }
}

Running from a clone instead? Use /path/to/Apple-MCPs/Apple-Calendar-MCP/start.sh as the command with empty args.

Claude Code example 
claude mcp add --transport stdio --scope project apple-calendar -- uvx apple-calendar-mcp

Safety Modes

  • safe_readonly
  • safe_manage
  • full_access

Transport

stdio is the default and recommended transport. Set APPLE_CALENDAR_MCP_TRANSPORT=streamable-http (with optional APPLE_CALENDAR_MCP_HOST and APPLE_CALENDAR_MCP_PORT) to serve Streamable HTTP instead.

macOS Permissions

  • Calendar access is required
  • calendar_health reports access_status, read access, and write access so agents can detect blocked permissions before treating an empty window as real data

Launch Checklist

  • Add uvx apple-calendar-mcp (or a clone's Apple-Calendar-MCP/start.sh) to your MCP client
  • Reload or reconnect the client so the Calendar tool surface is loaded into context
  • Call calendar_health first
  • If access is blocked or access_status is not_determined, call calendar_permission_guide
  • After changing macOS permissions, call calendar_recheck_permissions

Prompting Notes

  • tools/list returns the full Calendar tool surface. Context-constrained clients can use search_tools first, then get_tool_info for the Calendar tool they need.
  • Before creating events, confirm the date, time, duration, and title with the user
  • Use Calendar for scheduled time blocks, meetings, and appointments

Related

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.0.2)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for JonathanRReed from gravatar.com JonathanRReed

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Provides Extra

dev

Tags

mcp model-context-protocol macos apple ai-agent automation

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

apple_calendar_mcp-1.0.1.tar.gz (25.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

apple_calendar_mcp-1.0.1-py3-none-any.whl (23.4 kB view details)

Uploaded Python 3

File details

Details for the file apple_calendar_mcp-1.0.1.tar.gz.

File metadata

  • Download URL: apple_calendar_mcp-1.0.1.tar.gz
  • Upload date:
  • Size: 25.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for apple_calendar_mcp-1.0.1.tar.gz
Algorithm Hash digest
SHA256 8f6a732349e7a007f4f4ebcdb358471c9d59d69751431e2444181aaeb5b4b524
MD5 6bf07ca44dca9a317fe652adfda9017b
BLAKE2b-256 07ab4bb37b7f2aa440ec195423a2eb5e371faada4e1ff5da6a7f931580fb0efa

See more details on using hashes here.

Provenance

The following attestation bundles were made for apple_calendar_mcp-1.0.1.tar.gz:

Publisher: release.yml on JonathanRReed/Apple-MCPs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file apple_calendar_mcp-1.0.1-py3-none-any.whl.

File metadata

File hashes

Hashes for apple_calendar_mcp-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8b071c9cd07417e5d4975441255d07307d7d7b1d3063c974eb901a2a58473c4b
MD5 a5ca86da22e51188197c23594da1ba5a
BLAKE2b-256 29aca1b37b635b97bb7c7c4bc07f57815868d8b7904d2545d6fcde3f320060da

See more details on using hashes here.

Provenance

The following attestation bundles were made for apple_calendar_mcp-1.0.1-py3-none-any.whl:

Publisher: release.yml on JonathanRReed/Apple-MCPs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page