Macos calendar reminders skill
Manage Apple Calendar events and Apple Reminders on macOS via calctl.py and remindctl.py — self-contained EventKit CLI scripts. Use when the user wants to create, query, update, or delete calendar events or reminders on macOS.From its SKILL.md
npx -y skills add Cosmostima/macos-calendar-reminders-skillAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
- runs commandsInstructs the agent to run 8 commands, including `uv run scripts/calctl.py list` and 7 more.
SKILL.md
2.4 KB, 532 tokens by cl100k_base, as published. Nobody here has run it
macOS Calendar & Reminders
Two CLI tools for Apple Calendar (calctl.py) and Apple Reminders (remindctl.py). Dependencies auto-installed by uv.
Full reference: calctl.md · remindctl.md · authorization.md
Routing
| Scenario | Tool |
|---|---|
| Time blocks (meetings, appointments, events) | calctl — Calendar |
| Tasks / deadlines / todos | remindctl — Reminder |
Use list to discover available calendars and reminder lists before creating items.
Quick Reference
# Calendar
uv run scripts/calctl.py list
uv run scripts/calctl.py get --calendar all --start 2026-03-16 --end 2026-03-22
uv run scripts/calctl.py create --calendar Work --title "Meeting" --start 2026-03-20T14:00:00 --end 2026-03-20T15:00:00
uv run scripts/calctl.py search --query "review"
uv run scripts/calctl.py update --id "<event_id>" --start 2026-03-20T15:00:00 --end 2026-03-20T16:00:00
uv run scripts/calctl.py delete --calendar Work --id "<event_id>"
# Reminders
uv run scripts/remindctl.py list
uv run scripts/remindctl.py get today
uv run scripts/remindctl.py get week --list Work
uv run scripts/remindctl.py create --title "Submit report" --list Work --due 2026-03-20T23:59:00 --priority high
uv run scripts/remindctl.py search --query "assignment"
uv run scripts/remindctl.py update --id "<id>" --due 2026-03-21T23:59:00
uv run scripts/remindctl.py complete --id "<id>"
uv run scripts/remindctl.py delete --id "<id>" --confirm
Authorization
On first use, run status --authorize to trigger the macOS permission prompt:
uv run scripts/calctl.py status --authorize
uv run scripts/remindctl.py status --authorize
If permission is denied or the prompt doesn't appear, read authorization.md to guide the user through manual setup. Do not retry in a loop.
What ships with it: 9 files
68.1 KB alongside SKILL.md, 2 of them executable
references/
- authorization.md3.1 KB
- calctl.md4.8 KB
- remindctl.md5.1 KB
scripts/
- calctl.pyruns22.8 KB
- remindctl.pyruns28.7 KB
- .gitignore113 B
- LICENSE1.0 KB
- _meta.json150 B
- README.md2.4 KB