CalDAV Calendar

Calendar skill using khal/vdirsyncer. Self-hosted calendar integration for OpenClaw.

The CalDAV Calendar skill brings self-hosted calendar integration to OpenClaw using khal (a CLI calendar) and vdirsyncer (a CalDAV synchronization tool). Unlike cloud-dependent calendar integrations, this approach works with any CalDAV server — Nextcloud, Radicale, Baikal, iCloud, or even self-hosted Zimbra — giving you full control over your calendar data. The architecture uses vdirsyncer to pull calendar events from your CalDAV server to local storage, then khal provides a fast CLI interface for querying, creating, and modifying events. OpenClaw's agent interacts with khal commands to answer questions like 'What's on my calendar today?' or 'Schedule a meeting for Friday at 2pm.' Changes sync back to the CalDAV server, appearing on all your devices. For privacy-conscious users or those running self-hosted infrastructure, this is the calendar integration of choice. No data passes through Google or Microsoft servers. Your calendar events stay on your infrastructure, and the agent accesses them locally. It pairs naturally with the Nix packaging ecosystem, where khal and vdirsyncer are well-packaged and declaratively configurable.

Tags: calendar, caldav, skill, self-hosted

Category: infrastructure

Tips

  • Install khal and vdirsyncer first, then configure vdirsyncer to sync with your CalDAV server before installing the OpenClaw skill
  • Run `vdirsyncer discover` and `vdirsyncer sync` manually once to validate your CalDAV connection before automating
  • Set up a cron job to run `vdirsyncer sync` every 15 minutes so the agent always has fresh calendar data
  • Use khal's interactive mode (`khal interactive`) to verify events display correctly before relying on the agent's queries
  • For iCloud CalDAV, you'll need an app-specific password — regular iCloud passwords don't work with CalDAV clients

Community Feedback

Calendar skill using khal/vdirsyncer. Self-hosted calendar integration for OpenClaw. Works with any CalDAV server — your data, your infrastructure.

— ClawHub

Finally a calendar integration that doesn't require Google or Microsoft. CalDAV + khal + vdirsyncer is the self-hosted trifecta, and this skill ties it all together.

— OpenClaw Community

Frequently Asked Questions

Which CalDAV servers are compatible?

Any standard CalDAV server works: Nextcloud, Radicale, Baikal, iCloud, Google Calendar (via CalDAV), Fastmail, and Zimbra. If it speaks CalDAV, vdirsyncer can sync with it.

Can the agent create new calendar events?

Yes. The agent uses khal's event creation commands to add events, which then sync back to your CalDAV server via vdirsyncer. Events appear on all your devices after the next sync cycle.

How does it handle recurring events?

khal supports iCalendar's recurrence rules (RRULE). Recurring events display correctly in queries, and the agent can create new recurring events using standard recurrence patterns (daily, weekly, monthly).

Is this easier than using Google Calendar API directly?

It's different. The Google Calendar API requires OAuth setup and cloud dependency. CalDAV + khal is more work initially but gives you full data sovereignty and works with any CalDAV provider, not just Google.