caldav-calendar

Sync CalDAV calendars and manage events via vdirsyncer and khal.

Updated Feb 25, 2026
One-click install
npx skills add https://github.com/sky770825/NEUXA- --skill caldav-calendar-sky770825
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: caldav-calendar
Source: https://github.com/sky770825/NEUXA-/tree/main/quarantine/skills-archive-20260208/caldav-calendar
Command: npx skills add https://github.com/sky770825/NEUXA- --skill caldav-calendar-sky770825

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Users managing multiple CalDAV calendar services (iCloud, Google, Fastmail, Nextcloud etc.) on Linux lack a unified, CLI-based tool to sync, view, and manage all their events without switching between separate provider web interfaces.

Core Features & Use Cases

  • Cross-provider calendar sync: Sync events from any CalDAV provider to local .ics files using vdirsyncer, ensuring all calendars are up to date in one place.
  • Full event management: View, search, create, edit, and delete calendar events directly via the khal CLI, with support for custom output formats for scripting use cases.
  • Use case: Remote workers using both personal iCloud and work Google Calendars can consolidate all their events into a single local view, quickly check upcoming meetings, and add new events without logging into multiple services.

Quick Start

Use the caldav-calendar skill to sync your configured CalDAV calendars and list all your events for the next 7 days.

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 from multiple providers on Linux?

To sync CalDAV calendars from providers like iCloud, Google, and Fastmail on Linux, use vdirsyncer to pull events into local .ics files. This consolidates multiple remote calendar services into a single, up-to-date local directory.

What's the best way to manage CalDAV events via the command line?

Managing CalDAV events via the command line is best handled with khal, which supports viewing, searching, creating, editing, and deleting events directly from local .ics files synced by vdirsyncer, enabling full calendar lifecycle operations.

Do I need to pre-install vdirsyncer and khal to use CalDAV calendar sync?

Yes, you need to pre-install the vdirsyncer and khal binaries and configure their config files for your CalDAV provider. The calendar sync and management process relies on these existing local installations to function correctly.

Can I use khal to search and view upcoming calendar events locally?

Yes, you can use khal to search and view upcoming calendar events locally. It queries the synced local .ics files and supports custom output formats, allowing you to quickly list upcoming meetings or integrate results into scripting workflows.

Does vdirsyncer support syncing local .ics files with remote CalDAV servers?

Yes, vdirsyncer supports syncing local .ics files with remote CalDAV servers. It acts as the synchronization bridge between major providers like Nextcloud or Google and your local file system, ensuring all calendar events remain current.

Why use a CLI calendar sync approach instead of provider web interfaces?

Using a CLI calendar sync approach with vdirsyncer and khal eliminates the need to switch between separate provider web interfaces. It unifies events from multiple CalDAV providers into a single local view for faster, scriptable event management.