accli
by joargp
Calendar & SchedulingBrief
This skill should be used when interacting with Apple Calendar on macOS.
Description
What This Skill Does
accli is a command-line tool for reading and writing Apple Calendar data on macOS. It uses JavaScript for Automation to list calendars, query events by date range or keyword, create and update events, and check free/busy availability.
Gives agents and scripts direct calendar access without requiring GUI interaction or third-party calendar APIs.
When to Use It
- Checking what meetings are scheduled for today
- Finding a free time slot before booking a meeting
- Creating a recurring standup event from the terminal
- Searching past events by keyword across a calendar
- Deleting a cancelled appointment without opening Calendar.app
Example Workflow
User asks: Schedule a 1-hour team sync tomorrow at 2pm on my Work calendar
- 1
Run
accli calendars --jsonto confirm the Work calendar exists and get its ID - 2
Run
accli freebusy --calendar Work --from 2025-01-15T14:00 --to 2025-01-15T15:00 --jsonto verify the slot is free - 3
Confirm event details with the user before creating
- 4
Run
accli create Work --summary "Team Sync" --start 2025-01-15T14:00 --end 2025-01-15T15:00 --jsonto create the event
Event created with confirmation JSON including the new event ID and details
Requirements
- macOS (required — tool uses JavaScript for Automation, unavailable on other platforms)
Installation
clawhub install joargp/accliRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.