caldav-calendar — Claude Code skill: what it does, how to install
Syncs and reads CalDAV calendars directly from the terminal. Helps query agendas, find meetings, and insert events via command-line tools on Linux.
no license 267 installs ★ 675 updated 2026-03-07
npx skills add sundial-org/awesome-openclaw-skills --skill caldav-calendar -a claude-codeWhat caldav-calendar does
The skill connects an AI coding agent to external calendar providers like iCloud, Nextcloud, Fastmail, or Google Calendar. Under the hood, it pairs two CLI utilities: vdirsyncer downloads remote data into local .ics directories, while khal handles event lookups, formatting, and scheduling.
An agent can inspect daily agendas, filter date ranges, or book slots with khal new. Because khal edit operates interactively and demands a TTY session, automated event updates require running inside tmux.
This skill runs on Linux and depends on having both vdirsyncer and khal installed on the host, along with valid config files in ~/.config/vdirsyncer and ~/.config/khal.
What it helps with
- query agenda for today or the coming week
- insert new appointments into a specific calendar
- search past and upcoming events by keyword
- sync local
.icsstores with remote CalDAV accounts
Example prompts for the agent
- Check my agenda for today using khal
- Create a call for tomorrow at 14:00 in the Work calendar and run vdirsyncer sync
- Search the calendar for any events mentioning dentist
How to install caldav-calendar
1Skills CLI (Vercel)
npx skills add sundial-org/awesome-openclaw-skills --skill caldav-calendar -a claude-code2Manually: put the files in place
~/.claude/skills/caldav-calendar/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/caldav-calendar/
1Skills CLI (Vercel)
npx skills add sundial-org/awesome-openclaw-skills --skill caldav-calendar -a codex2Manually: put the files in place
.agents/skills/caldav-calendar/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add sundial-org/awesome-openclaw-skills --skill caldav-calendar -a cursor2Manually: put the files in place
.cursor/skills/caldav-calendar/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install sundial-org/awesome-openclaw-skills skills/caldav-calendar2Manually: put the files in place
.github/skills/caldav-calendar/SKILL.md1Skills CLI (Vercel)
npx skills add sundial-org/awesome-openclaw-skills --skill caldav-calendar -a gemini-cli2Platform CLI
gemini skills install https://github.com/sundial-org/awesome-openclaw-skills --path skills/caldav-calendarManually: put the files in place
.devin/skills/caldav-calendar/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add sundial-org/awesome-openclaw-skills --skill caldav-calendar -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about caldav-calendar
How do I install caldav-calendar in Claude Code?
Run npx skills add sundial-org/awesome-openclaw-skills --skill caldav-calendar -a claude-code. The skill definition will be placed in ~/.claude/skills/caldav-calendar/SKILL.md.
What does caldav-calendar do?
It enables command-line calendar management for your assistant via vdirsyncer and khal. It lets the agent list schedules, look up details, and add events locally before syncing changes upstream.
What prerequisites are required for caldav-calendar?
The skill requires Linux with vdirsyncer and khal installed via your package manager. You must also configure calendar accounts in ~/.config/vdirsyncer/config and set paths in ~/.config/khal/config.