# Send Caldav to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "caldav-skill", "name": "Caldav", "source": "tencent", "type": "skill", "category": "效率提升", "sourceUrl": "https://clawhub.ai/Chakyiu/caldav-skill", "canonicalUrl": "https://clawhub.ai/Chakyiu/caldav-skill", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/caldav-skill", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=caldav-skill", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "scripts/calendars.py", "scripts/events.py", "scripts/radicale.py", "scripts/todos.py", "scripts/utils.py" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "caldav-skill", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-29T07:33:22.749Z", "expiresAt": "2026-05-06T07:33:22.749Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=caldav-skill", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=caldav-skill", "contentDisposition": "attachment; filename=\"caldav-skill-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "caldav-skill" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/caldav-skill" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/caldav-skill", "downloadUrl": "https://openagent3.xyz/downloads/caldav-skill", "agentUrl": "https://openagent3.xyz/skills/caldav-skill/agent", "manifestUrl": "https://openagent3.xyz/skills/caldav-skill/agent.json", "briefUrl": "https://openagent3.xyz/skills/caldav-skill/agent.md" } } ``` ## Documentation ### CalDAV & Radicale Management Interact with CalDAV servers (calendars, events, todos) and manage Radicale server configurations. ### Overview CalDAV is a protocol for accessing and managing calendaring information (RFC 4791). Radicale is a lightweight CalDAV/CardDAV server. This skill enables: Calendar CRUD operations (create, list, update, delete) Event management (create, update, delete, query) Todo/task management Radicale server configuration and administration ### Python Library Install the caldav library: pip install caldav For async support: pip install caldav[async] ### Environment Variables (Recommended) Store credentials securely in environment or config: export CALDAV_URL="http://localhost:5232" export CALDAV_USER="your_username" export CALDAV_PASSWORD="your_password" Or use a config file at ~/.config/caldav/config.json: { "url": "http://localhost:5232", "username": "your_username", "password": "your_password" } ### Calendar Operations # List all calendars python3 {baseDir}/scripts/calendars.py list # Create a new calendar python3 {baseDir}/scripts/calendars.py create --name "Work Calendar" --id work # Delete a calendar python3 {baseDir}/scripts/calendars.py delete --id work # Get calendar info python3 {baseDir}/scripts/calendars.py info --id work ### Event Operations # List events (all calendars, next 30 days) python3 {baseDir}/scripts/events.py list # List events from specific calendar python3 {baseDir}/scripts/events.py list --calendar work # List events in date range python3 {baseDir}/scripts/events.py list --start 2024-01-01 --end 2024-01-31 # Create an event python3 {baseDir}/scripts/events.py create \\ --calendar work \\ --summary "Team Meeting" \\ --start "2024-01-15 14:00" \\ --end "2024-01-15 15:00" \\ --description "Weekly sync" # Create all-day event python3 {baseDir}/scripts/events.py create \\ --calendar personal \\ --summary "Birthday" \\ --start 2024-02-14 \\ --allday # Update an event python3 {baseDir}/scripts/events.py update \\ --uid "event-uid-here" \\ --summary "Updated Title" # Delete an event python3 {baseDir}/scripts/events.py delete --uid "event-uid-here" # Search events by text python3 {baseDir}/scripts/events.py search --query "meeting" ### Todo Operations # List todos python3 {baseDir}/scripts/todos.py list [--calendar name] # Create a todo python3 {baseDir}/scripts/todos.py create \\ --calendar work \\ --summary "Complete report" \\ --due "2024-01-20" # Complete a todo python3 {baseDir}/scripts/todos.py complete --uid "todo-uid-here" # Delete a todo python3 {baseDir}/scripts/todos.py delete --uid "todo-uid-here" ### Radicale Server Management # Check Radicale status python3 {baseDir}/scripts/radicale.py status # List users (from htpasswd file) python3 {baseDir}/scripts/radicale.py users list # Add user python3 {baseDir}/scripts/radicale.py users add --username newuser # View Radicale config python3 {baseDir}/scripts/radicale.py config show # Validate Radicale config python3 {baseDir}/scripts/radicale.py config validate # Check storage integrity python3 {baseDir}/scripts/radicale.py storage verify ### Direct HTTP/DAV Operations For low-level operations, use curl with CalDAV: # Discover principal URL curl -u user:pass -X PROPFIND \\ -H "Depth: 0" \\ -H "Content-Type: application/xml" \\ -d '' \\ http://localhost:5232/ # List calendars curl -u user:pass -X PROPFIND \\ -H "Depth: 1" \\ -H "Content-Type: application/xml" \\ -d '' \\ http://localhost:5232/user/ # Query events by time range curl -u user:pass -X REPORT \\ -H "Depth: 1" \\ -H "Content-Type: application/xml" \\ -d ' ' \\ http://localhost:5232/user/calendar/ # Create calendar (MKCALENDAR) curl -u user:pass -X MKCALENDAR \\ -H "Content-Type: application/xml" \\ -d ' New Calendar ' \\ http://localhost:5232/user/new-calendar/ ### Config File Location Radicale looks for config in: /etc/radicale/config (system-wide) ~/.config/radicale/config (user) Custom path via --config or RADICALE_CONFIG env ### Key Configuration Sections [server] hosts = localhost:5232 max_connections = 20 max_content_length = 100000000 timeout = 30 ssl = False [auth] type = htpasswd htpasswd_filename = /etc/radicale/users htpasswd_encryption = autodetect [storage] filesystem_folder = /var/lib/radicale/collections [rights] type = owner_only ### Authentication Types TypeDescriptionnoneNo authentication (development only!)denyallDeny all (default since 3.5.0)htpasswdApache htpasswd fileremote_userWSGI-provided usernamehttp_x_remote_userReverse proxy headerldapLDAP/AD authenticationdovecotDovecot auth socketimapIMAP server authenticationoauth2OAuth2 authenticationpamPAM authentication ### Creating htpasswd Users # Create new file with SHA-512 htpasswd -5 -c /etc/radicale/users user1 # Add another user htpasswd -5 /etc/radicale/users user2 ### Running as Service (systemd) # Enable and start sudo systemctl enable radicale sudo systemctl start radicale # Check status sudo systemctl status radicale # View logs journalctl -u radicale -f ### iCalendar Format Quick Reference Events use iCalendar (RFC 5545) format: BEGIN:VCALENDAR VERSION:2.0 PRODID:-//Example Corp//CalDAV Client//EN BEGIN:VEVENT UID:unique-id@example.com DTSTAMP:20240115T120000Z DTSTART:20240115T140000Z DTEND:20240115T150000Z SUMMARY:Team Meeting DESCRIPTION:Weekly sync LOCATION:Conference Room END:VEVENT END:VCALENDAR ### Common Properties PropertyDescriptionUIDUnique identifierDTSTARTStart timeDTENDEnd timeDTSTAMPCreation/modification timeSUMMARYEvent titleDESCRIPTIONEvent descriptionLOCATIONLocationRRULERecurrence ruleEXDATEExcluded datesATTENDEEParticipantORGANIZEREvent organizerSTATUSCONFIRMED/TENTATIVE/CANCELLED ### Date Formats # DateTime with timezone DTSTART:20240115T140000Z ; UTC (Z suffix) DTSTART;TZID=America/New_York:20240115T090000 # All-day event DTSTART;VALUE=DATE:20240214 # DateTime local (floating) DTSTART:20240115T140000 ### Connection Issues # Test basic connectivity curl -v http://localhost:5232/ # Check with authentication curl -v -u user:pass http://localhost:5232/ # Verify CalDAV support curl -X OPTIONS http://localhost:5232/ -I | grep -i dav ### Common Errors ErrorCauseSolution401 UnauthorizedWrong credentialsCheck htpasswd file403 ForbiddenRights restrictionCheck [rights] config404 Not FoundWrong URL pathCheck principal/calendar path409 ConflictResource existsUse different UID415 Unsupported Media TypeWrong Content-TypeUse text/calendar ### Debug Mode Run Radicale with debug logging: python3 -m radicale --debug ### Python API Quick Reference from caldav import DAVClient # Connect client = DAVClient( url="http://localhost:5232", username="user", password="pass" ) # Get principal principal = client.principal() # List calendars for cal in principal.calendars(): print(f"Calendar: {cal.name} ({cal.url})") # Create calendar cal = principal.make_calendar(name="My Calendar", cal_id="my-cal") # Create event cal.save_event( dtstart="2024-01-15 14:00", dtend="2024-01-15 15:00", summary="Meeting" ) # Query events by date range events = cal.date_search( start="2024-01-01", end="2024-01-31" ) for event in events: print(event.vobject_instance.vevent.summary.value) # Get event by UID event = cal.event_by_uid("event-uid") # Delete event event.delete() # Create todo todo = cal.save_todo( summary="Task", due="2024-01-20" ) ### Create Recurring Event python3 {baseDir}/scripts/events.py create \\ --calendar work \\ --summary "Weekly Standup" \\ --start "2024-01-15 09:00" \\ --end "2024-01-15 09:30" \\ --rrule "FREQ=WEEKLY;BYDAY=MO,WE,FR" ### Export Calendar to ICS # Via curl curl -u user:pass http://localhost:5232/user/calendar/ > calendar.ics # Via script python3 {baseDir}/scripts/calendars.py export --id work --output work.ics ### Sync with Git (Radicale) Configure Radicale to version changes: [storage] hook = git add -A && (git diff --cached --quiet || git commit -m "Changes by \\"%(user)s\\"") Initialize git in storage folder: cd /var/lib/radicale/collections git init git config user.email "radicale@localhost" ## Trust - Source: tencent - Verification: Indexed source record - Publisher: Chakyiu - Version: 1.0.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-04-29T07:33:22.749Z - Expires at: 2026-05-06T07:33:22.749Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/caldav-skill) - [Send to Agent page](https://openagent3.xyz/skills/caldav-skill/agent) - [JSON manifest](https://openagent3.xyz/skills/caldav-skill/agent.json) - [Markdown brief](https://openagent3.xyz/skills/caldav-skill/agent.md) - [Download page](https://openagent3.xyz/downloads/caldav-skill)