caldav-calendar

name	caldav-calendar
description	Sync and query CalDAV calendars (iCloud, Google, Fastmail, Nextcloud, etc.) using vdirsyncer + khal. Works on Linux.
version	1.0.3
metadata	{"clawdbot":{"emoji":"📅","os":["linux"],"requires":{"bins":"[Truncated]"},"install":["[Truncated]"]}}
display_name	caldav-calendar
display_name_en	caldav-calendar
description_zh	同步和查询 CalDAV 日历（iCloud、Google、Fastmail、Nextcloud 等），仅支持 Linux
description_en	Sync and query CalDAV calendars (iCloud, Google, Fastmail, Nextcloud) with vdirsyncer + khal, Linux only
visibility	public

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:

vdirsyncer sync

View Events

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

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

Create Events

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:

vdirsyncer sync

Edit Events (interactive)

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

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:

vdirsyncer