Setup & Installation
openclaw skills install @joargp/accli
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install accli
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
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: Schedule a 1-hour team sync tomorrow at 2pm on my Work calendar
AGENT
- 1Run `accli calendars --json` to confirm the Work calendar exists and get its ID
- 2Run `accli freebusy --calendar Work --from 2025-01-15T14:00 --to 2025-01-15T15:00 --json` to verify the slot is free
- 3Confirm event details with the user before creating
- 4Run `accli create Work --summary "Team Sync" --start 2025-01-15T14:00 --end 2025-01-15T15:00 --json` to create the event
OUTPUT
Event created with confirmation JSON including the new event ID and details
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.
macOS (required — tool uses JavaScript for Automation, unavailable on other platforms)