caldav-calendar

What This Skill Does

The caldav-calendar skill provides a robust command-line interface for managing your digital calendars directly through the OpenClaw agent. By leveraging the industry-standard vdirsyncer for bidirectional synchronization and khal for efficient local management, this skill allows users to view, search, create, and edit calendar events across various providers including iCloud, Google, Fastmail, and Nextcloud. It effectively bridges the gap between remote cloud-based calendars and local file systems, ensuring that your schedule is accessible and programmable via the terminal.

Installation

To install this skill, use the OpenClaw command: clawhub install openclaw/skills/skills/bigdonuts0/caldav-calendar-1-0-1. Before use, ensure both vdirsyncer and khal are installed on your Linux system. Configuration is divided into two parts: setting up your synchronization credentials in ~/.config/vdirsyncer/config and configuring your calendar views in ~/.config/khal/config. Once configured, run vdirsyncer sync to pull your initial calendar data. For a complete guide, refer to the provided configuration templates to ensure proper directory paths are set for your local cache and calendar storage.

Use Cases

This skill is ideal for power users and developers who wish to integrate their personal or work calendars into automated workflows. Use cases include:

• Aggregating multiple calendars (Work, Personal, Family) into a single terminal view.
• Scripting recurring tasks: Automate adding "Time blocks" to your calendar based on incoming emails or project tickets.
• Querying availability: Quickly search for specific meetings or upcoming deadlines without opening a graphical browser interface.
• Offline access: Since data is synced to local .ics files, you can read your schedule even without an active internet connection after a successful sync.

Example Prompts

1. "Sync my calendar and list all meetings scheduled for the next 3 days."
2. "Search my calendars for 'dentist' and show me the date and title of the next appointment."
3. "Create a new event titled 'Project Sync' for tomorrow at 2:00 PM and sync the changes."

Tips & Limitations

• Sync Discipline: Always execute vdirsyncer sync before querying to ensure your data is current. Failing to do so may result in working with stale information.
• Interactive Limitations: The khal edit command is interactive and requires a TTY. If you are running this within an automated script, consider using tmux or screen to handle the interactive shell requirements.
• Cache Issues: If you notice discrepancies between your remote calendar and the local view, simply remove the cache file at ~/.local/share/khal/khal.db. It will be automatically regenerated upon the next sync.