Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
Added more instruction for how to update events
What This Skill Does
Syncs CalDAV calendars from providers like iCloud, Google, Fastmail, and Nextcloud to local .ics files using vdirsyncer, then reads and writes them with khal. Supports listing, searching, creating, and editing events from the command line. Linux only.
Gives offline-capable, scriptable calendar access without a GUI, so agents can query and modify calendar data directly from the command line.
When to use it
- Checking today's or next week's events from the terminal
- Creating a meeting on iCloud Calendar without opening a browser
- Searching past events by keyword across all calendars
- Scripting calendar queries with custom date and title output formats
- Pushing locally created or edited events back to a remote CalDAV server
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: What do I have scheduled in the next 7 days?
- 1Run vdirsyncer sync to fetch latest events from the remote CalDAV server
- 2Run khal list today 7d to retrieve events for the next 7 days
- 3Apply --format to extract start date, time range, and title fields
- 4Return the structured list to the user
A formatted list of upcoming events with dates, times, and titles for the next 7 days
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.