Voltar a Skills

Caldav Calendar

Sync and query CalDAV calendars from iCloud, Google, Fastmail, and Nextcloud using vdirsyncer and khal. View, create, search, and edit calendar events directly from the terminal on Linux.

por Asleep
Productivity & TasksProductivity

# Caldav Calendar Sync and query CalDAV calendars from iCloud, Google, Fastmail, and Nextcloud using vdirsyncer and khal. View, create, search, and edit calendar events directly from the terminal on Linux. CalDAV Calendar bridges your cloud calendars with the command line. It uses vdirsyncer to sync CalDAV calendars to local .ics files and khal to read, create, search, and edit events — all without leaving the terminal. ## How It Works 1 Step 1 Sync Run vdirsyncer sync to pull the latest events from your CalDAV provider (iCloud, Google, Fastmail, Nextcloud, etc.) to local .ics files. 2 Step 2 Query Use khal list and khal search to view upcoming events, browse date ranges, or find events by keyword. 3 Step 3 Create & Edit Use khal new to add events and khal edit to modify or delete them interactively. 4 Step 4 Push Changes Run vdirsyncer sync again after creating or editing events to push changes back to the server. ## Key Features - **Multi-Provider Support**: Works with iCloud, Google, Fastmail, Nextcloud, and any CalDAV-compatible server. - **Flexible Event Listing**: View today's events, a date range, the next N days, or events from a specific calendar with khal list . - **Event Search**: Find events by keyword with khal search and customize output format with placeholders like {title} , {start-date} , {calendar} . - **Quick Event Creation**: Create timed events, all-day events, and events with descriptions using khal new . - **Interactive Editing**: Edit summaries, descriptions, datetimes, locations, or delete events via khal edit . - **Scriptable Output**: Use --format with placeholders ( {uid} , {title} , {start-time} , etc.) for machine-readable output. - **Conflict Resolution**: vdirsyncer handles sync conflicts with configurable resolution strategies. ## Requirements - **vdirsyncer**: CalDAV sync tool that downloads and uploads .ics files. - **khal**: Terminal calendar viewer and editor that reads the synced files. - **Linux**: This skill is designed for Linux systems. Both tools are available via apt. - **CalDAV Account**: A calendar provider that supports CalDAV (iCloud, Google, Fastmail, Nextcloud, etc.). ## Use Cases - **Schedule Awareness**: Let your AI agent check your calendar before scheduling meetings or planning tasks. - **Quick Event Creation**: Create events from the terminal without switching to a browser or phone. - **Calendar Search**: Search across all your calendars for specific events, people, or topics. - **Automated Workflows**: Integrate calendar operations into scripts or agent workflows using the scriptable output format. - **Multi-Calendar Management**: View and manage events across personal and work calendars from a single interface. ## Installation Install via: `npx clawhub@latest install caldav-calendar`

Instalação

1

Execute no seu terminal

npx clawhub@latest install caldav-calendar
2

Clique no botão Instalar no topo desta página para configuração com um clique