Agent skill · software engineering · sundial-org
caldav-calendar
Sync and query CalDAV calendars (iCloud, Google, Fastmail, Nextcloud, etc.) using vdirsyncer + khal. Works on Linux.
Why this skill is useful
Provides specific commands and configuration examples for syncing and managing CalDAV calendars that the AI wouldn't reliably generate on its own.
What it needs
Requires khal, vdirsyncer installed locally. About 2k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
CalDAV Calendar (vdirsyncer + khal) vdirsyncer syncs CalDAV calendars to local .ics files. khal reads and writes them. Sync First Always sync before querying or after making changes: View Events Search Create Events After creating, sync to push changes: Edit Events (interactive) khal edit is interactive — requires a TTY. Use tmux if automating: Menu options: s → edit summary d → edit description t → edit datetime range l → edit location D → delete event n → skip (save changes, next match) q → quit After editing, sync: Delete Events Use khal edit, then press D to delete. Output Formats For scripting: Placeholders: {title}, {description}, {start}, {end}, {start-date}, {start-time}, {end-date}, {end-time}, {location}, {calendar}, {uid} Caching khal caches events in ~/.local/share/khal/khal.db. If data looks stale after syncing: Initial Setup 1. Configure vdirsyncer (~/.config/vdirsyncer/config) Example for iCloud: Provider URLs: iCloud: https://caldav.icloud.com/ Google: Use googlecalendar storage type Fastmail: https://caldav.fastmail.com/dav/calendars/user/EMAIL/ Nextcloud: https://YOUR.CLOUD/remote.php/dav/calendars/USERNAME/ 2. Configure khal (~/.config/khal/config) 3. Discover and sync
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/caldav-calendar