@purplesquirrel/apple-calendar-mcp
v0.1.0
Published
MCP server for Apple Calendar — manage events via AppleScript
Readme
Apple Calendar MCP
MCP server for Apple Calendar -- manage events via AppleScript.
Install
npm install
npm run buildUsage
npm startOr register in ~/.mcp.json:
{
"apple-calendar": {
"command": "node",
"args": ["/path/to/apple-calendar-mcp/dist/index.js"]
}
}Tools (7)
| Tool | Description |
|------|-------------|
| calendar_list | List all calendars (name, color, account) |
| calendar_events_today | Get today's events, optionally filtered by calendar |
| calendar_events_range | Get events between two dates |
| calendar_create_event | Create a new event (title, start, end, calendar, location, notes) |
| calendar_delete_event | Delete an event by uid |
| calendar_search | Search events by text across titles, locations, and notes |
| calendar_upcoming | Get next N upcoming events sorted by date |
Requirements
- macOS with Calendar.app
- Node.js 18+
- Calendar.app automation permissions (granted on first run)
