apple-calendar — Claude Code plugin: what it does, install
The apple-calendar plugin for Claude Code and Codex connects to local macOS Calendar and Reminders for agenda views, event creation, and reminder management.
MIT ★ 1,596 updated 2026-10-29
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install apple-calendar@awesome-codex-pluginsWhat apple-calendar does
This plugin connects Claude Code and Codex to the local macOS Calendar. A Python wrapper in scripts/apple_calendar.py works with a Swift EventKit backend, exposing calendar aliases, today and tomorrow agendas, free-time lookup, event search, and reminder controls.
It can add events with conflict and duplicate checks, find entries by title and date, update or remove them, and handle daily or weekly recurrence. The command set also supports .ics export and import. The package includes config.json, .mcp.json, and the skill file skills/apple-calendar/SKILL.md.
The Swift backend compiles on first use and after its source changes. Calendar access must be granted to the app running Codex, or the plugin cannot read or change events.
What it helps with
- view today’s or tomorrow’s agenda
- find an open time slot
- add an event while checking conflicts
- change a reminder on an existing event
- export a day as an
.icsfile
Example prompts for the agent
- Show today’s agenda and find open time windows.
- Add “Stolní Tenis” to calendar
domatoday at 15:00 for 60 minutes, only when the slot is free. - Export tomorrow’s events from calendar
domato/tmp/events.ics.
How to install apple-calendar
Plugin marketplace
/plugin marketplace add hashgraph-online/awesome-codex-plugins/plugin install apple-calendar@awesome-codex-pluginsStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about apple-calendar
How do I install apple-calendar in Claude Code?
Run /plugin marketplace add hashgraph-online/awesome-codex-plugins, then run /plugin install apple-calendar@awesome-codex-plugins.
What does apple-calendar do?
It gives Claude Code and Codex local access to macOS Calendar and Reminders through a Python CLI and Swift/EventKit backend. It handles events, recurrence, reminders, and .ics files.
What does apple-calendar need to work?
The app running Codex needs permission to access macOS Calendar. The Swift backend builds on its first use and when its Swift source changes.
Source text
apple-productivity-mcp · MIT
# Apple Calendar Plugin [](https://github.com/matk0shub/apple-productivity-mcp/releases/latest) [](https://github.com/matk0shub/apple-productivity-mcp) Local Codex plugin for macOS Calendar with a Python CLI wrapper and a Swift/EventKit backend. ## What It Covers - list calendars with aliases - daily agenda views with `today`, `tomorrow`, and `agenda` - free-window lookup with `free` - create events with conflict and duplicate protection - find events by title and day - update or delete existing events - set or clear reminders - recurring events with daily or weekly recurrence - `.ics` export and import ## Main Files - `scripts/apple_calendar.py` - `scripts/apple_calendar_backend.swift` - `.mcp.json` - `config.json` - `skills/apple-calendar/SKILL.md` ## Common Commands Show today's agenda: ```bash /usr/bin/python3 scripts/apple_calendar.py today ``` Add an event: ```bash /usr/bin/python3 scripts/apple_calendar.py add \ --calendar doma \ --title "Stolní Tenis" \ --date today \ --start-time 15:00 \ --duration-minutes 60 \ --if-free ``` Find an event: ```bash /usr/bin/python3 scripts/apple_calendar.py find-events \ --calendar doma \ --title "Stolní Tenis" \ --date today ``` Update reminders: ```bash /usr/bin/python3 scripts/apple_calendar.py set-reminder \ --calendar doma \ --title "Stolní Tenis" \ --date today \ --minutes-before 30 ``` Export one day to `.ics`: ```bash /usr/bin/python3 scripts/apple_calendar.py export-ics \ --calendar doma \ --date tomorrow \ --days 1 \ --output /tmp/events.ics ``` ## Notes - This plugin requires macOS Calendar permission for the app that runs Codex. - The Swift backend auto-compiles on first use or when the Swift source changes. - Event identifiers remain stable under the EventKit backend, including recurring updates. ## Enable In Codex 1. Open this repository in Codex. 2. Install or expose the local plugin so Codex can see `plugins/apple-calendar/.codex-plugin/plugin.json`. 3. Ensure macOS Calendar access is enabled for the app running Codex. 4. The plugin now also points at the shared local MCP server via `.mcp.json`. 5. Start using either: - the skill prompts from `skills/apple-calendar/SKILL.md` - or the MCP tools exposed by the shared `apple-productivity` server ## MCP Note This plugin now consumes the shared local MCP server from `mcp/apple-productivity`. That means: - you can use the Apple Calendar skill directly in Codex - and the same backend is also available as MCP tools without duplicating business logic ## Links - [Latest release](https://github.com/matk0shub/apple-productivity-mcp/releases/latest) - [Repository root](https://github.com/matk0shub/apple-productivity-mcp)
© matty · MIT · hashgraph-online/awesome-codex-plugins