macos-calendar-reminders-skill

Give your agent the ability to manage Apple Calendar and Apple Reminders on macOS.

• Built on the native EventKit framework — no AppleScript overhead, fast and reliable
• Two self-contained CLI scripts with dependencies auto-resolved by uv, zero configuration
• Full CRUD support for both calendar events and reminders

Features

Tool	Commands	Description
calctl.py	list · get · create · search · update · delete	Manage calendar events
remindctl.py	list · get · create · search · update · complete · delete	Manage reminders

📦 Installation

Requirements

• macOS (requires EventKit framework)
• uv (Python package manager, brew install uv)

Agent Install ✨ (Recommended)

Send the following to your agent:

Install the macOS Calendar & Reminders skill:

1. Clone the repo: git clone https://github.com/Cosmostima/macos-calendar-reminders-skill.git
2. Copy the macos-calendar-reminders-skill directory (including SKILL.md, scripts/, and references/) into your skills directory
3. Run uv run scripts/calctl.py status --authorize and uv run scripts/remindctl.py status --authorize to trigger authorization
4. If not authorized, read macos-calendar-reminders-skill/references/authorization.md and guide the user to approve it

Manual Install

1. Clone the repository

git clone https://github.com/Cosmostima/macos-calendar-reminders-skill.git

2. Place the skill directory where your agent can access it

For example, copy it to your agent's skill directory:

cp -r macos-calendar-reminders-skill /path/to/your/skills/

3. Authorize access

On first use, trigger the macOS permission prompt:

uv run scripts/calctl.py status --authorize
uv run scripts/remindctl.py status --authorize

Approve the prompt when it appears. If permission is denied or no prompt shows up, go to System Settings → Privacy & Security → Calendars / Reminders and manually grant access to your terminal app.

License

MIT