{"id":"6b331851-efdf-46c3-8b20-83f4eb92183d","slug":"s-morgan-jeffries-apple-calendar-mcp","kind":"mcp","name":"apple-calendar-mcp","summary":"MCP server for Apple Calendar integration via AppleScript","owner":"s-morgan-jeffries","repoUrl":"https://github.com/s-morgan-jeffries/apple-calendar-mcp","license":"MIT","licenseTier":"permissive","trust":"community","stars":9,"match":null,"fewStars":false,"format":"mcp","createdAt":"2026-03-15T12:39:00.000Z","addedAt":"2026-10-21T17:00:08.285Z","logoUrl":"https://avatars.githubusercontent.com/u/2607440?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["productivity","cloud-infra"],"tags":[],"runtime":"python","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-25T15:42:15.708Z","sample":false,"url":"https://conduits.dev/tools/s-morgan-jeffries-apple-calendar-mcp","language":"Python","transports":["stdio"],"install":{"pypi":"apple-calendar-mcp"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# Apple Calendar MCP Server\n\n[![CI](https://github.com/s-morgan-jeffries/apple-calendar-mcp/actions/workflows/test.yml/badge.svg)](https://github.com/s-morgan-jeffries/apple-calendar-mcp/actions/workflows/test.yml)\n[![Coverage](https://img.shields.io/badge/coverage-97%25-brightgreen)](https://github.com/s-morgan-jeffries/apple-calendar-mcp)\n[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org)\n[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)\n\nA comprehensive, fast, reliable, and agent-friendly [MCP](https://modelcontextprotocol.io/) server for Apple Calendar on macOS.\n\n## Why This Server\n\n### Comprehensive\n\n10 tools covering the full calendar lifecycle — more than any other dedicated Apple Calendar MCP server. Full CRUD for events and calendars, plus batch operations (`create_events`, `update_events`), text search, smart availability with working hours and minimum duration filters, and conflict detection. Complete recurring event support with iCalendar RRULE — create, update, and delete individual occurrences or entire series.\n\n### Fast\n\nAll event operations use Swift/EventKit via native subprocess for sub-second performance, even on calendars with thousands of events. Calendar management uses AppleScript where it's fast enough.\n\n| Operation | Typical Time | Notes |\n|-----------|-------------|-------|\n| List calendars | 0.5s | 16 calendars |\n| Read events (1 month) | 0.6s | ~100 events |\n| Read events (1 year) | 0.7s | ~1,400 events |\n| Create event | 0.5s | |\n| Update event | 0.6s | |\n| Delete events (batch of 5) | 0.4s | Single commit |\n\n### Reliable\n\n97% code coverage from 184 unit tests. 59 integration tests run against real Calendar.app — covering round-trip data integrity, recurring event edge cases, special characters, alerts, year-boundary queries, and more. Calendar safety guards prevent accidental writes to real calendars during testing.\n\n### Agent-Friendly\n\nEvery tool docstring includes detailed `Returns` sections documenting fields, types, and chaining info — so Claude knows that `create_events` returns UIDs usable by `update_events` without guessing. 38 blind agent eval scenarios validate tool usability across multiple models.\n\n| Model | Score | Safety |\n|-------|-------|--------|\n| Claude Sonnet 4 | 76/76 (100%) | 5/5 |\n| DeepSeek V3 | 71/76 (93%) | 5/5 |\n| Mistral Large 2411 | 70/76 (92%) | 5/5 |\n| Qwen 2.5 72B | 69/76 (91%) | 5/5 |\n| Llama 3.3 70B | 63/76 (83%) | 5/5 |\n\nAll models pass all safety-critical scenarios. [Full results](evals/agent_tool_usability/results/scored_results.md).\n\n## Tools (10)\n\n### Calendars\n\n| Tool | Description |\n|------|-------------|\n| `get_calendars` | List all calendars with names, access levels, descriptions, and colors |\n| `create_calendar` | Create a new calendar |\n| `delete_calendar` | Delete a calendar and all its events |\n\n### Events\n\n| Tool | Description |\n|------|-------------|\n| `get_events` | Query events in a date range |\n| `search_events` | Search events by text across one or all calendars |\n| `create_events` | Create one or more events in one operation |\n| `update_events` | Update one or more events by UID, with full recurrence support |\n| `delete_events` | Delete one or more events by UID |\n\n### Scheduling\n\n| Tool | Description |\n|------|-------------|\n| `get_availability` | Find free time slots across calendars, with optional working hours and minimum duration filters |\n| `get_conflicts` | Detect double-bookings and overlapping events across calendars |\n\n## Prerequisites\n\n- **macOS** (Apple Calendar is macOS-only)\n- **Python 3.10+**\n- **Xcode Command Line Tools** — required for Swift helper compilation (`xcode-select --install`)\n\n## Installation\n\n```bash\n# With uv (recommended)\nuv tool install apple-calendar-mcp\n\n# With pip\npip install apple-calendar-mcp\n```\n\n## Configuration\n\n### Claude Desktop\n\nAdd to your Claude Desktop MCP config (`~/Library/Application Support/Claude/claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"apple-calendar\": {\n      \"command\": \"uvx\",\n      \"args\": [\"apple-calendar-mcp\"]\n    }\n  }\n}\n```\n\nOr if running from a local clone:\n\n```json\n{\n  \"mcpServers\": {\n    \"apple-calendar\": {\n      \"command\": \"uv\",\n      \"args\": [\"run\", \"--directory\", \"/path/to/apple-calendar-mcp\", \"python\", \"-m\", \"apple_calendar_mcp.server_fastmcp\"]\n    }\n  }\n}\n```\n\n### Other MCP Clients\n\nRun the server directly:\n\n```bash\napple-calendar-mcp\n```\n\nOr from source:\n\n```bash\nuv run python -m apple_calendar_mcp.server_fastmcp\n```\n\n## Permissions\n\nOn first use, macOS will prompt for calendar access permission. Grant access to allow the server to read and write calendar events. The Swift helpers use EventKit, which requires the \"Full Disk Access\" or \"Calendars\" permission depending on your macOS version.\n\n## Development\n\n```bash\nmake install           # Create venv and install dependencies\nmake test              # Run all tests (176 unit, 58 integration)\nmake test-unit         # Unit tests only\nmake test-integration  # Integration tests (requires test calendar)\nmake complexity        # Check cyclomatic complexity\nmake audit             # Check dependencies for vulnerabilities\n```\n\nAll dates use ISO 8601 format in local time: `\"2026-03-15\"` for date-only or `\"2026-03-15T14:30:00\"` for date-time. Do not append \"Z\" — dates are not UTC.\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## License\n\n[MIT](LICENSE)\n"}