CalDAV-Cal-API

Python library and command-line interface for CalDAV calendars (VEVENTs).

Warning

This project is fully vibecoded. Every line was written by Claude Code, from an architecture I specified but did not hand-write, and I have not audited it line by line. Read it before pointing it at a calendar you care about, and keep backups.

It exists because I wanted what my CalDAV-Tasks-API gives me for tasks (VTODOs), but for calendar events (VEVENTs). It therefore mimics that project’s layout and architecture on purpose, so the two feel like the same library from the outside.

Contents:

• Usage
  • Configuration
  • Command line
• Guide
  • Python API
  • Data structures
• Examples
  • Runnable scripts
• Tests
  • Offline
  • Server-backed
• FAQ
  • When does anything actually reach the server?
  • Why does get_event_by_global_uid() return None for an event I can see in my calendar app?
  • How are recurring events handled?
  • Can I edit a single occurrence of a recurring event?
  • Why is dtend the day after my all-day event ends?
  • Will updating an event destroy its attendees or reminders?
  • What happens to a timezone my system does not know?
  • Why is to_ical() output using CRLF line endings?
  • How do X- properties work?
• API Reference
  • caldav_cal_api

Indices and tables

• Index

• Module Index

• Search Page