Caldav Calendar

• You want an AI agent to read, create, or search calendar events across popular CalDAV providers (iCloud, Google, Fastmail, Nextcloud).
• You need scripted or automated calendar access on a Linux machine without a GUI.
• You want structured event output (dates, titles, UIDs, descriptions) for downstream processing or reporting.
• You need to push new events to a remote CalDAV server and keep the local store in sync.

• You are not on Linux — this skill explicitly requires a Linux environment.
• You need real-time calendar streaming or push notifications; vdirsyncer is a pull-based sync tool.
• You need interactive, TTY-based event editing in a fully automated (non-TTY) pipeline — khal edit requires a terminal.

Uses vdirsyncer to sync calendars from iCloud, Google, Fastmail, Nextcloud, or any standard CalDAV server. Events are stored locally as .ics files for fast, offline access.

Use khal list to view today's events, the next N days, a specific date range, or a single named calendar. Supports natural-language shorthands like today, tomorrow, and 7d.

Search across all synced events by keyword with khal search. Custom --format strings let you extract exactly the fields you need (title, date, UID, location, etc.).

Create timed or all-day events on any calendar with khal new, including optional descriptions and target calendar selection. After creation, vdirsyncer sync pushes changes back to the remote server.

Format event output using placeholders like {title}, {start-date}, {uid}, {calendar}, and {location} — making it easy to pipe calendar data into other tools or agents.

khal maintains a local cache at ~/.local/share/khal/khal.db. If events appear stale after syncing, the cache can be cleared to force a fresh read from the local .ics store.

An agent runs vdirsyncer sync then khal list today 7d each morning to pull the week's events and summarize them in natural language for the user.

An agent receives a meeting request in natural language, creates the event with khal new, and syncs it back to iCloud or Nextcloud — no manual calendar app interaction needed.

An agent searches the calendar for existing commitments using khal search and khal list before suggesting free time slots or scheduling new work.

Using custom --format strings, an agent extracts structured event data (UIDs, titles, calendars, timestamps) for logging, reporting, or syncing to external systems.