Skip to main content
plugin CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install apple-calendar@awesome-codex-plugins
Open on GitHub

What 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 .ics file

Example prompts for the agent

  • Show today’s agenda and find open time windows.
  • Add “Stolní Tenis” to calendar doma today at 15:00 for 60 minutes, only when the slot is free.
  • Export tomorrow’s events from calendar doma to /tmp/events.ics.

How to install apple-calendar

Plugin marketplace

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install apple-calendar@awesome-codex-plugins

Step 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

[![Release](https://img.shields.io/github/v/release/matk0shub/apple-productivity-mcp?display_name=tag)](https://github.com/matk0shub/apple-productivity-mcp/releases/latest)
[![Repo](https://img.shields.io/badge/repo-apple--productivity--mcp-4B7BEC)](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

Similar plugins

All plugins for Notes, tasks and projects →

From the same set391

The whole set →
babeldoc-pdf-translate babeldoc-pdf-translate translates PDF files while preserving the original visual layout using a local BabelDOC engine, custom glossaries, and bilingual output. CX Codex ★ 1,596repo stars axonflow axonflow is a Claude Code plugin that checks Codex actions against policies, detects PII and secrets, and records audit events. Blocked calls get a decision_id. CX Codex ★ 1,596repo stars autocad-tianzheng-tools autocad-tianzheng-tools wires Claude to AutoCAD and Tianzheng HVAC through a local MCP server, so the agent can open DWG drawings and carry out drawing operations. CX Codex ★ 1,596repo stars arcmira arcmira searches YouTube and podcast transcripts for timestamped quotes, speakers, and sponsors. It helps analyze brand mentions and prep for interviews. CX Codex ★ 1,596repo stars antigravity-2 Runs a local Windows bridge between Claude and the Antigravity 2.0 desktop app, with MCP tools for setup checks, model limits and chat handoff. CX Codex ★ 1,596repo stars anime-reaction-gif anime-reaction-gif — a plugin for Claude Code and Codex that builds looping reaction GIFs and MP4s from generated pose sheets. It drives image_gen for key poses, then hands the frames to FFmpeg for timing and export. CX Codex ★ 1,596repo stars aient Connect Claude Code to Aient’s MCP server to inspect production telemetry, investigate problems, and work through remediation. Useful when an agent needs operational context. CX Codex ★ 1,596repo stars aident-loadout aident-loadout — a remote MCP server that gives your agent access to the apps you authorise and 400+ skills, with a single setup shared across Claude, Claude and other clients. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open