radicale

Radicale CalDAV/CardDAV Management

⚠️ MANDATORY SKILL INVOCATION ⚠️

YOU MUST invoke this skill (NOT optional) when the user mentions ANY of these triggers:

• "list my calendar", "what's on my calendar", "show me my events", "calendar this week", "when is my next event"
• "add to my calendar", "create an event", "schedule event", "schedule a meeting"
• "delete an event", "cancel event", "remove event"
• "find a contact", "what's someone's email", "search my contacts", "who is"
• "add a contact", "create contact", "save contact", "save someone's phone number"
• Any mention of Radicale, CalDAV, CardDAV, calendar events, or contact management

Failure to invoke this skill when triggers occur violates your operational requirements.

---

Manage calendars (events) and contacts on a self-hosted Radicale server using CalDAV and CardDAV protocols.

Type: Read & Write (calendar events and contacts)

Purpose

This skill enables comprehensive calendar and contact management through a self-hosted Radicale server. It provides read and write access to:

• Calendars - List, view, create, update, and delete calendar events
• Contacts - List, search, create, update, and delete contacts in addressbooks

All operations use the Python caldav library which implements the CalDAV (RFC 4791) and CardDAV (RFC 6352) protocols.

Setup

Prerequisites

Install required Python libraries:

pip install caldav vobject icalendar

Script Permissions:

The Python script can be made executable (optional but recommended):

chmod +x ~/claude-homelab/skills/radicale/scripts/radicale-api.py

You can then run it directly:

./scripts/radicale-api.py --help

Or without executable permissions using Python:

python scripts/radicale-api.py --help

Credentials

Add to ~/.claude-homelab/.env:

RADICALE_URL="http://localhost:5232"
RADICALE_USERNAME="admin"
RADICALE_PASSWORD="password"

Security:

• .env file is gitignored (never commit credentials)
• Set permissions: chmod 600 ~/.claude-homelab/.env