caldav-sync
Calendar and task management via CalDAV protocol. Query, create, edit, and delete calendar events and todos. Free/busy query, multi-account support.
Rank
62
Safety
84
Downloads
1.1k
Updated
Oct 11, 2026
Version
1.0.3
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1.1K downloadsadoption · observed Oct 11, 2026
- Latest release
- 1.0.3release · observed May 22, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17en8axd9552m9fpmxvhkq9xd83gnb1:caldav-sync- Install using `clawhub skill install s17en8axd9552m9fpmxvhkq9xd83gnb1:caldav-sync` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/gzlicanyi/caldav-sync before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-gzlicanyi-caldav-sync/snapshot"
Run-check
$0.02 USD1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.
Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.
Documentation
CLAWHUB
45,080 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: caldav-sync
description: Calendar and task management via CalDAV protocol. Query, create, edit, and delete calendar events and todos. Free/busy query, multi-account support.
metadata:
openclaw:
emoji: "📅"
requires:
bins:
- node
- npm
env:
- PROVIDER
- USERNAME
- PASSWORD
primaryEnv: PROVIDER
---
# CalDAV Sync Tool
Manage calendar events and todos via CalDAV protocol. Supports Google Calendar, iCloud, Nextcloud, Fastmail, NetEase (163/126/yeah.net), and any standard CalDAV server.
## Configuration
Run the setup script to install dependencies and configure your CalDAV account:
```bash
bash setup.sh
```
If running commands manually without setup.sh, install dependencies first:
```bash
npm install --production
```
Configuration is stored at `~/.config/mail-skills/.env` (shared with imap-smtp-email skill). If no shared config is found, the skill falls back to a `.env` file in the skill directory.
### Config file format
```bash
# Default account
PROVIDER=163
[email protected]
PASSWORD=your_password
CALDAV_DEFAULT_CALENDAR=
```
The `PROVIDER` preset auto-fills the CalDAV server URL. For custom servers:
```bash
PROVIDER=custom
[email protected]
PASSWORD=your_password
CALDAV_SERVER_URL=https://your-caldav-server.com/
```
## Multi-Account
You can configure additional accounts in the same config file. Each account uses a name prefix (uppercase) on all variables.
```bash
# Work account (WORK_ prefix)
WORK_PROVIDER=gmail
[email protected]
WORK_PASSWORD=app_password
WORK_CALDAV_DEFAULT_CALENDAR=work
```
Add `--account <name>` before the command:
```bash
node scripts/caldav.js --account work list-calendars
node scripts/caldav.js --account work list-events --start 2026-01-01 --end 2026-12-31
```
## Supported Providers
| Provider | Server URL | Auth |
|----------|-----------|------|
| Google Calendar | `https://calendar.google.com/calendar/dav/` | App Password |
| iCloud | `https://caldav.icloud.com/` | App-Specific Password |
| Nextcloud | `https://<host>/remote.php/dav/calendars/<user>/` | Username/Password |
| Fastmail | `https://caldav.fastmail.com/dav/` | Username/Password |
| NetEase (163/126/yeah.net) | `https://caldav.163.com/` | Authorization Code |
| NetEase Enterprise (North) | `https://caldav.qiye.163.com/` | Username/Password |
| NetEase Enterprise (East) | `https://caldavhz.qiye.163.com/` | Username/Password |
## Commands
### list-calendars
List all available calendars.
```bash
node scripts/caldav.js [--account <name>] list-calendars
```
### list-events
Query events in a time range.
```bash
node scripts/caldav.js [--account <name>] list-events --start <date> --end <date> [--calendar <id>] [--force-refresh]
```
### get-event
Get a specific event by UID.
```bash
node scripts/caldav.js [--account <name>] get-event --uid <uid> [--calendar <id>]
```
### create-event
Create a new calendar event.
```bash
node scripts/caldav.js [_meta.json
{
"ownerId": "kn70j4ejnwqjpykvwwvgymmdcd8055qp",
"slug": "caldav-sync",
"version": "1.0.3",
"publishedAt": 1779460071449
}skill-card.md
## Description: Calendar and task management via CalDAV protocol. Query, create, edit, and delete calendar events and todos. Free/busy query, multi-account support. This skill is ready for commercial/non-commercial use. ## Publisher: [gzlicanyi](https://clawhub.ai/user/gzlicanyi) ### License/Terms of Use: MIT-0 ## Use Case: Developers and agents use this skill to manage CalDAV calendars and task lists across supported providers, including querying availability, listing calendars, and creating, updating, or deleting events and todos. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: The skill handles reusable calendar credentials and cached private calendar or task data. Mitigation: Install only for trusted CalDAV servers, prefer provider presets or HTTPS-only custom endpoints, use app-specific passwords where available, and remove cached data and plaintext credentials when no longer needed. Risk: The skill can create, modify, and delete remote calendar events and todos. Mitigation: Review requested write operations before execution and use the narrowest suitable account or calendar scope. ## Reference(s): - [ClawHub skill page](https://clawhub.ai/gzlicanyi/skills/caldav-sync) - [Publisher profile](https://clawhub.ai/user/gzlicanyi) - [Google App Passwords](https://myaccount.google.com/apppasswords) - [Related imap-smtp-email skill](https://clawhub.ai/gzlicanyi/imap-smtp-email) ## Skill Output: **Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration] **Output Format:** [Markdown with JSON command output and inline shell commands] **Output Parameters:** [1D] **Other Properties Related to Output:** [May read and write remote calendar/task data and local CalDAV configuration or cache files.] ## Skill Version(s): 1.0.3 (source: server release evidence) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
package-lock.json
{
"name": "caldav-sync-skill",
"version": "1.0.0",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "caldav-sync-skill",
"version": "1.0.0",
"license": "MIT",
"dependencies": {
"dotenv": "^16.6.1",
"ical.js": "^1.5.0",
"tsdav": "^2.1.8"
}
},
"node_modules/base-64": {
"version": "1.0.0",
"resolved": "https://registry.npmjs.org/base-64/-/base-64-1.0.0.tgz",
"integrity": "sha512-kwDPIFCGx0NZHog36dj+tHiwP4QMzsZ3AgMViUBKI0+V5n4U0ufTCUMhnQ04diaRI8EX/QcPfql7zlhZ7j4zgg==",
"license": "MIT"
},
"node_modules/debug": {
"version": "4.4.3",
"resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
"integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
"license": "MIT",
"dependencies": {
"ms": "^2.1.3"
},
"engines": {
"node": ">=6.0"
},
"peerDependenciesMeta": {
"supports-color": {
"optional": true
}
}
},
"node_modules/dotenv": {
"version": "16.6.1",
"resolved": "https://registry.npmjs.org/dotenv/-/dotenv-16.6.1.tgz",
"integrity": "sha512-uBq4egWHTcTt33a72vpSG0z3HnPuIl6NqYcTrKEg2azoEyl2hpW0zqlxysq2pK9HlDIHyHyakeYaYnSAwd8bow==",
"license": "BSD-2-Clause",
"engines": {
"node": ">=12"
},
"funding": {
"url": "https://dotenvx.com"
}
},
"node_modules/ical.js": {
"version": "1.5.0",
"resolved": "https://registry.npmjs.org/ical.js/-/ical.js-1.5.0.tgz",
"integrity": "sha512-7ZxMkogUkkaCx810yp0ZGKvq1ZpRgJeornPttpoxe6nYZ3NLesZe1wWMXDdwTkj/b5NtXT+Y16Aakph/ao98ZQ==",
"license": "MPL-2.0"
},
"node_modules/ms": {
"version": "2.1.3",
"resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
"integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
"license": "MIT"
},
"node_modules/sax": {
"version": "1.6.0",
"resolved": "https://registry.npmjs.org/sax/-/sax-1.6.0.tgz",
"integrity": "sha512-6R3J5M4AcbtLUdZmRv2SygeVaM7IhrLXu9BmnOGmmACak8fiUtOsYNWUS4uK7upbmHIBbLBeFeI//477BKLBzA==",
"license": "BlueOak-1.0.0",
"engines": {
"node": ">=11.0.0"
}
},
"node_modules/tsdav": {
"version": "2.2.2",
"resolved": "https://registry.npmjs.org/tsdav/-/tsdav-2.2.2.tgz",
"integrity": "sha512-/uC/RItcdYVxUj8b2gT4CorAkUmDFUuzhgS4XVT+OVzGRE80hH5ldubcWH13dHa2T9rNaXu6UIEWHlQ1UL7H1Q==",
"license": "MIT",
"dependencies": {
"base-64": "1.0.0",
"debug": "4.4.3",
"xml-js": "1.6.11"
},
"engines": {
"node": ">=18"
}
},
"node_modules/xml-js": {
"version": "1.6.11",
"resolved": "https://registry.npmjs.org/xml-js/-/xml-js-1.6.11.tgz",
"integrity": "sha512-7rVi2KMfwfWFl+Gppackage.json
{
"name": "caldav-sync-skill",
"version": "1.0.0",
"description": "CalDAV calendar and todo management tool. Supports events and tasks via CalDAV protocol with multi-account support.",
"main": "scripts/caldav.js",
"scripts": {
"list-calendars": "node scripts/caldav.js list-calendars",
"list-events": "node scripts/caldav.js list-events",
"list-todos": "node scripts/caldav.js list-todos"
},
"dependencies": {
"dotenv": "^16.6.1",
"ical.js": "^1.5.0",
"tsdav": "^2.1.8"
},
"keywords": [
"caldav",
"calendar",
"todo",
"icalendar",
"skill"
],
"author": "NetEase",
"license": "MIT"
}AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/gzlicanyi/skills/caldav-sync",
"sourceUrl": "https://clawhub.ai/gzlicanyi/skills/caldav-sync",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T14:24:13.718Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-gzlicanyi-caldav-sync/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-gzlicanyi-caldav-sync/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T14:24:13.718Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.1K downloads",
"href": "https://clawhub.ai/gzlicanyi/caldav-sync",
"sourceUrl": "https://clawhub.ai/gzlicanyi/caldav-sync",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T14:24:13.718Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.3",
"href": "https://clawhub.ai/gzlicanyi/caldav-sync",
"sourceUrl": "https://clawhub.ai/gzlicanyi/caldav-sync",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-22T14:27:51.449Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-gzlicanyi-caldav-sync/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-gzlicanyi-caldav-sync/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.3",
"description": "Incremental sync and caching support added. - Added incremental synchronization for events and todos to improve sync speed and efficiency. - Introduced caching for sync state per account and calendar at `~/.config/mail-skills/caldav-cache/`. - New `--force-refresh` option to bypass cache and force a full sync. - Write operations now automatically invalidate the cache to ensure up-to-date data. - Added scripts/cache.js and scripts/sync.js to implement caching and sync logic.",
"href": "https://clawhub.ai/gzlicanyi/caldav-sync",
"sourceUrl": "https://clawhub.ai/gzlicanyi/caldav-sync",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-22T14:27:51.449Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.
