Skip to content
TakoAPI
Back to skills

caldav-calendar

by asleep123

Calendar & Scheduling
19.6kDownloads reported by clawskills.sh
173Stars
21Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Sync and query CalDAV calendars.

Description

What This Skill Does

Syncs CalDAV calendars from providers like iCloud, Google, Fastmail, and Nextcloud to local .ics files using vdirsyncer, then reads and writes them with khal. Supports listing, searching, creating, and editing events from the command line. Linux only.

Gives offline-capable, scriptable calendar access without a GUI, so agents can query and modify calendar data directly from the command line.

When to Use It

  • Checking today's or next week's events from the terminal
  • Creating a meeting on iCloud Calendar without opening a browser
  • Searching past events by keyword across all calendars
  • Scripting calendar queries with custom date and title output formats
  • Pushing locally created or edited events back to a remote CalDAV server

Example Workflow

INPUT

User asks: What do I have scheduled in the next 7 days?

AGENT
  1. 1

    Run vdirsyncer sync to fetch latest events from the remote CalDAV server

  2. 2

    Run khal list today 7d to retrieve events for the next 7 days

  3. 3

    Apply --format to extract start date, time range, and title fields

  4. 4

    Return the structured list to the user

OUTPUT

A formatted list of upcoming events with dates, times, and titles for the next 7 days

Requirements

  • CalDAV account credentials (iCloud, Google Calendar, Fastmail, Nextcloud, or other provider)
  • App-specific password if using iCloud, required for third-party CalDAV access

Installation

clawhub install asleep123/caldav-calendar

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links