ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified productivity Safety 4/5

caldav-calendar

Sync and query CalDAV calendars (iCloud, Google, Fastmail, Nextcloud, etc.) using vdirsyncer + khal. Works on Linux.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/asleep123/caldav-calendar
Or

What This Skill Does

The caldav-calendar skill provides a robust interface for OpenClaw to interact with your personal or professional calendars. By leveraging the power of vdirsyncer for synchronization and khal for command-line calendar management, this skill enables seamless local and remote calendar operations. It effectively bridges the gap between cloud-based providers like iCloud, Google, Fastmail, or Nextcloud and your local environment, treating your calendar data as standard files that can be queried, manipulated, and scheduled via the terminal.

Installation

To get started, first ensure your environment has the necessary dependencies (vdirsyncer and khal) installed on your Linux system. Once prerequisites are met, install the skill using the command: clawhub install openclaw/skills/skills/asleep123/caldav-calendar. After installation, you must configure your vdirsyncer credentials in ~/.config/vdirsyncer/config and map your local calendars in ~/.config/khal/config. Always run vdirsyncer sync initially to populate your local database from your cloud providers.

Use Cases

This skill is ideal for users who want to manage their schedule without relying on browser-based UI. It is perfect for developers who prefer terminal workflows, power users automating their personal productivity, and those seeking to integrate calendar events into system scripts. You can use it to list upcoming project deadlines, quickly add meetings via voice or text prompts, or search through historical event archives using regex or simple keywords.

Example Prompts

  1. "Sync my calendar and show me all my meetings for the next three days."
  2. "Add a new team sync meeting tomorrow at 2 PM to my Work calendar and save the changes."
  3. "Search for the dentist appointment in my calendar and give me the date and time."

Tips & Limitations

Always remember to execute vdirsyncer sync after making any modifications; otherwise, your local changes will not propagate to the cloud. Interactive commands like khal edit require a terminal environment with TTY; avoid using them in automated background scripts unless wrapped in a session like tmux. If event data appears outdated, the ~/.local/share/khal/khal.db cache file can be safely removed to force a fresh import from your synchronized .ics files. Note that while this skill is highly versatile, it is currently limited to Linux-based environments.

Metadata

Author@asleep123
Stars4473
Views2
Updated2026-05-01
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-asleep123-caldav-calendar": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Tags(AI)

#calendar#productivity#linux#sync#dav
Safety Score: 4/5

Flags: network-access, file-write, file-read