A Linux-based command-line tool for syncing and managing CalDAV calendars like iCloud and Google via vdirsyncer and khal.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install caldav-calendar
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install caldav-calendar using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is CalDAV Calendar Sync & Management?
This skill enables seamless integration between remote CalDAV providers and your local command-line environment. By leveraging Openclaw Skills, developers and power users can interact with iCloud, Google, Fastmail, and Nextcloud calendars directly from the terminal. It utilizes vdirsyncer as a robust synchronization engine to handle bidirectional updates between local directories and remote servers, while khal provides the primary interface for listing, searching, and creating calendar events.
The toolset is designed specifically for Linux environments, providing a bridge between cloud-based scheduling services and terminal-based productivity workflows. It allows for offline access to calendar data through local .ics file storage, ensuring that Openclaw Skills can operate even without an active internet connection by interacting with the cached data.
CalDAV Calendar Sync & Management Use Cases
- Automated calendar queries and event listings within custom shell scripts or agentic workflows.
- Unified management of multiple calendar providers including iCloud, Google, and Nextcloud in one terminal interface.
- Programmatic creation of calendar events and meetings as part of a developer productivity suite using Openclaw Skills.
- Fast searching of historical events and future appointments without opening a heavy web browser or GUI application.
How CalDAV Calendar Sync & Management Works
- The workflow begins with vdirsyncer, which connects to remote CalDAV servers to fetch and sync events into local .ics files.
- Users interact with the localized data using khal to list, search, or display specific date ranges and event details.
- New events are created or existing ones are edited locally via khal commands, which updates the local filesystem storage.
- A final synchronization step with vdirsyncer pushes the local modifications back to the remote server to maintain consistency across all devices.
- Openclaw Skills maintain an internal cache in a local SQLite database to ensure high-performance querying and searching.
CalDAV Calendar Sync & Management Setup
To get started with this skill on Linux, install the necessary binaries using your package manager:
sudo apt update && sudo apt install vdirsyncer khal
- Create the configuration file at
~/.config/vdirsyncer/configand define yourstorageandpairsections for your specific provider (e.g., iCloud or Google). - Create the khal configuration at
~/.config/khal/configto point to the local storage path used by vdirsyncer. - Run the discovery and initial sync commands to populate your local database. This setup is essential for enabling Openclaw Skills to access your schedule:
vdirsyncer discover
vdirsyncer sync
CalDAV Calendar Sync & Management Data Schema & Taxonomy
The skill organizes calendar data through a combination of configuration files, raw .ics files, and a local cache database:
| Component | Purpose | Default Path |
|---|---|---|
| vdirsyncer Config | Defines remote sync pairs and authentication | ~/.config/vdirsyncer/config |
| khal Config | Defines calendar display and locale settings | ~/.config/khal/config |
| ICS Storage | Raw calendar event files (.ics) | ~/.local/share/vdirsyncer/calendars/ |
| Metadata Status | Tracks synchronization state | ~/.local/share/vdirsyncer/status/ |
| Event Cache | SQLite database used by khal for fast lookups | ~/.local/share/khal/khal.db |
CalDAV Calendar Sync & Management Advanced Features
- Interactive event editing and deletion via khal's TTY interface, ideal for manual management within a terminal multiplexer like tmux.
- Extensive support for custom output formatting using placeholders like
{uid},{title}, and{start-time}for easy integration with other Openclaw Skills. - Support for multi-calendar aggregation, allowing users to discover and sync all sub-calendars from a single remote provider automatically.
- Conflict resolution policies (e.g., "a wins" or "b wins") configurable within the vdirsyncer storage settings to handle sync collisions.
- Capability to handle all-day events and specific time-range queries spanning several months or years.
SKILL.md
Loading
Related Openclaw Skills
Bitwarden
A secure bridge for AI agents to access and manage Bitwarden and Vaultwarden credentials via the rbw CLI.
Azion Deploy
A high-performance deployment wrapper for the Azion CLI designed to automate the publishing of edge functions and static sites with safety-first validation.
Workflows via Ask Gina
A standardized framework for authoring, running, and optimizing Gina sandbox automation workflows with built-in evaluation loops.
Obsidian Organizer
Standardize and maintain your Obsidian vault structure for maximum long-term reliability and searchability.
OpenSSL Secure Generation
A specialized tool for generating cryptographically secure random data, including passwords, hex strings, and API tokens using the OpenSSL engine.
GNU Units
A high-performance calculation engine that leverages the classic GNU Units utility to perform precise mathematical and unit transformations.
Featured*
