PopularFree
productivityPopularFree
caldav-calendar
Sync and query any CalDAV calendar provider directly from your Linux terminal using vdirsyncer and khal.
24.3kdownloads·194favorites·5(review)
A
by asleep123Sync and query any CalDAV calendar provider directly from your Linux terminal using vdirsyncer and khal.
Stop relying on bulky GUIs or complex APIs to manage your schedule on Linux. You sync remote calendars locally using vdirsyncer and control events via khal commands to view, create, or edit entries. This skill supports iCloud, Google, and NextCloud providers seamlessly without proprietary dependencies. It is perfect for you if you seek privacy-focused, scriptable calendar access directly from your terminal.
Copy the prompt below and paste it into OpenClaw:
Please follow the instructions at https://clawshelf.com/api/skills/asleep123-caldav-calendar/install to download and install this skill to the local ~/.openclaw/skills/ directory.
Package contents
---
name: caldav-calendar
description: Sync and query CalDAV calendars (iCloud, Google, Fastmail, Nextcloud, etc.) using vdirsyncer + khal. Works on Linux.
metadata: {"clawdbot":{"emoji":"📅","os":["linux"],"requires":{"bins":["vdirsyncer","khal"]},"install":[{"id":"apt","kind":"apt","packages":["vdirsyncer","khal"],"bins":["vdirsyncer","khal"],"label":"Install vdirsyncer + khal via apt"}]}}
---
# 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 `D` 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 = "[email protected]"
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
```
No reviews yet. Be the first to review this skill.
100% native OpenClaw / Claude support