English |
A Model Context Protocol (MCP) server providing native integration with Apple Reminders and Calendar on macOS via the EventKit framework. Exposes reminders, lists, subtasks, and calendar events through a standardized interface with full CRUD operations.
The EventKit backend is the standalone event Swift CLI, vendored as a git submodule and built into bin/event during pnpm install — no separate brew install required. See event.
- Features
- Prerequisites
- Quick Start
- Configuration
- macOS Permissions
- Usage Examples
- Available MCP Tools
- Structured Prompt Library
- Development
- License
- Contributing
- Full CRUD for reminders, subtasks, reminder lists, and calendar events
- Priority (high/medium/low/none), tags, and checklist subtasks with progress tracking
- Multi-criteria filtering: completion, due-date range, priority, tags, full-text search, recurring, location-based
- Flexible date formats (
YYYY-MM-DD,YYYY-MM-DD HH:mm:ss, ISO 8601) with timezone awareness - Native macOS integration via EventKit — values configured in Reminders.app / Calendar.app round-trip through read responses
- Automatic macOS permission discovery and prompting
- Full Unicode support with comprehensive input validation
- Node.js 20 or later
- macOS (required for EventKit)
- Xcode Command Line Tools (only when building from source)
- pnpm (recommended)