caldav-calendar

Synchronize CalDAV calendars to local .ics files using vdirsyncer and khal.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/Muchunpeng/openclaw-config --skill caldav-calendar-muchunpeng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: caldav-calendar
Source: https://github.com/Muchunpeng/openclaw-config/tree/main/workspace/skills/caldav-calendar
Command: npx skills add https://github.com/Muchunpeng/openclaw-config --skill caldav-calendar-muchunpeng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps CalDAV calendars in sync locally by mirroring remote calendars into ICS files and enabling fast access and querying with khal.

Core Features & Use Cases

  • Bidirectional syncing between CalDAV servers and local ICS files
  • Querying and managing events via khal on Linux
  • Multi-calendar support across iCloud, Google, Nextcloud, and Fastmail for offline access

Quick Start

Install vdirsyncer and khal, configure a CalDAV pair, and run an initial vdirsyncer sync to populate local calendars.

Frequently Asked Questions about caldav-calendar

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync CalDAV calendars to local ICS files on Linux?

You can sync CalDAV calendars to local ICS files on Linux by configuring vdirsyncer to mirror remote calendar servers into local directories, enabling offline access to your events.

What is the best way to access synced CalDAV events offline?

The best way to access synced CalDAV events offline is by using vdirsyncer to download calendars into local ICS files and khal to query and manage those events directly from your Linux terminal.

Does vdirsyncer work with iCloud and Nextcloud for calendar syncing?

Yes, vdirsyncer works with iCloud, Nextcloud, Google, and Fastmail to provide bidirectional calendar syncing, mirroring remote CalDAV servers into local ICS files for offline access.

How do I query and manage local ICS calendar files using khal?

You can query and manage local ICS calendar files by running khal after configuring it to point to your synced vdirsyncer directories, allowing fast terminal-based access to your events.

Do I need to configure vdirsyncer and khal before syncing CalDAV calendars?

Yes, you need to install the vdirsyncer and khal binaries and set up a CalDAV pair in ~/.config/vdirsyncer along with khal configuration in ~/.config/khal before running an initial sync.

Can I sync multiple CalDAV calendars for offline access on Linux?

Yes, you can sync multiple CalDAV calendars for offline access on Linux, allowing fast local querying across different calendar accounts using vdirsyncer and khal.