caldav-calendar

Original：🇺🇸 English

Translated

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

2installs

Sourcesundial-org/awesome-openclaw-skills

Added on2026-03-11

NPX Install

npx skill4agent add sundial-org/awesome-openclaw-skills caldav-calendar

SKILL.md Content

View Translation Comparison →

CalDAV Calendar (vdirsyncer + khal)

vdirsyncer syncs CalDAV calendars to local

.ics

files. khal reads and writes them.

Sync First

Always sync before querying or after making changes:

bash

vdirsyncer sync

View Events

bash

khal list                        # Today
khal list today 7d               # Next 7 days
khal list tomorrow               # Tomorrow
khal list 2026-01-15 2026-01-20  # Date range
khal list -a Work today          # Specific calendar

Search

bash

khal search "meeting"
khal search "dentist" --format "{start-date} {title}"

Create Events

bash

khal new 2026-01-15 10:00 11:00 "Meeting title"
khal new 2026-01-15 "All day event"
khal new tomorrow 14:00 15:30 "Call" -a Work
khal new 2026-01-15 10:00 11:00 "With notes" :: Description goes here

After creating, sync to push changes:

bash

vdirsyncer sync

Edit Events (interactive)

khal edit

is interactive — requires a TTY. Use tmux if automating:

bash

khal edit "search term"
khal edit -a CalendarName "search term"
khal edit --show-past "old event"

Menu options:

```
s
```
→ edit summary
```
d
```
→ edit description
```
t
```
→ edit datetime range
```
l
```
→ edit location
```
D
```
→ delete event
```
n
```
→ skip (save changes, next match)
```
q
```
→ quit

After editing, sync:

bash

vdirsyncer sync

Delete Events

Use

khal edit

, then press

to delete.

Output Formats

For scripting:

bash

khal list --format "{start-date} {start-time}-{end-time} {title}" today 7d
khal list --format "{uid} | {title} | {calendar}" today

Placeholders:

{title}

,

{description}

,

{start}

,

{end}

,

{start-date}

,

{start-time}

,

{end-date}

,

{end-time}

,

{location}

,

{calendar}

,

{uid}

Caching

khal caches events in

~/.local/share/khal/khal.db

. If data looks stale after syncing:

bash

rm ~/.local/share/khal/khal.db

Initial Setup

1. Configure vdirsyncer (

~/.config/vdirsyncer/config

)

Example for iCloud:

ini

[general]
status_path = "~/.local/share/vdirsyncer/status/"

[pair icloud_calendar]
a = "icloud_remote"
b = "icloud_local"
collections = ["from a", "from b"]
conflict_resolution = "a wins"

[storage icloud_remote]
type = "caldav"
url = "https://caldav.icloud.com/"
username = "your@icloud.com"
password.fetch = ["command", "cat", "~/.config/vdirsyncer/icloud_password"]

[storage icloud_local]
type = "filesystem"
path = "~/.local/share/vdirsyncer/calendars/"
fileext = ".ics"

Provider URLs:

iCloud:
```
https://caldav.icloud.com/
```
Google: Use
```
google_calendar
```
storage type

Fastmail:

https://caldav.fastmail.com/dav/calendars/user/EMAIL/

Nextcloud:

https://YOUR.CLOUD/remote.php/dav/calendars/USERNAME/

2. Configure khal (

~/.config/khal/config

)

ini

[calendars]
[[my_calendars]]
path = ~/.local/share/vdirsyncer/calendars/*
type = discover

[default]
default_calendar = Home
highlight_event_days = True

[locale]
timeformat = %H:%M
dateformat = %Y-%m-%d

3. Discover and sync

bash

vdirsyncer discover   # First time only
vdirsyncer sync

caldav-calendar

NPX Install

Tags

SKILL.md Content

CalDAV Calendar (vdirsyncer + khal)

Sync First

View Events

Search

Create Events

Edit Events (interactive)

Delete Events

Output Formats

Caching

Initial Setup

1. Configure vdirsyncer (
`~/.config/vdirsyncer/config`
)

2. Configure khal (
`~/.config/khal/config`
)

3. Discover and sync

caldav-calendar

NPX Install

Tags

SKILL.md Content

CalDAV Calendar (vdirsyncer + khal)

Sync First

View Events

Search

Create Events

Edit Events (interactive)

Delete Events

Output Formats

Caching

Initial Setup

1. Configure vdirsyncer (~/.config/vdirsyncer/config)

2. Configure khal (~/.config/khal/config)

3. Discover and sync

1. Configure vdirsyncer (
`~/.config/vdirsyncer/config`
)

2. Configure khal (
`~/.config/khal/config`
)