wecom-calendar-cli — archived, superseded by Tencent’s official wecom-cli

Capabilities

A local, queryable, annotatable mirror of your calendars

Sync once, query offline, and annotate events with output a coding agent can act on.

Incremental sync

Pull CalDAV changes into SQLite by per-calendar change-tag — unchanged calendars are skipped, only moved events re-fetched. Idempotent, with --full and --dry-run.

Query events offline

List events in any --since/--until window straight from the local store — recurring events expanded per occurrence, cross-calendar duplicates removed.

Agent-owned metadata

Attach free-form annotations to events by UID — namespaces, keys, JSON values — to classify them or link them to external tasks. Sync never touches them, so they survive every re-sync.

Local store, first-class

A stateful SQLite mirror you can query offline and annotate. Deleted events are soft-deleted (tombstoned), keeping history — and its metadata — resolvable.

Agent-first output

JSON by default, with structured errors — categories, exit codes and recovery hints a coding agent can branch on, and a stale notice when the store falls behind.

WeCom CalDAV handled

The non-standard Tencent backend — bare /calendar/ home, per-.ics GET bodies, non-IANA embedded TZIDs — is handled for you. Credentials live in the OS keychain.

Install

Up and running in a minute

Install with npm, then finish setup in two steps — deploy the Skill, then turn on shell completion.

install

# recommended — fetches the prebuilt binary for your platform
npm install -g @angelmsger/wecom-calendar-cli

Other methods — go install, a source build, or a prebuilt binary from the Releases page.

Then finish setup:

1 · Companion Skill

A wecom-calendar Skill is embedded in the binary. It detects your coding agent — Claude Code, Codex — and installs for each:

$ wecom-calendar-cli skill install

2 · Shell completion

Completes subcommands, flag values and live calendar ids. Load it once:

$ source <(wecom-calendar-cli completion bash)

Credential note. Auth is HTTP Basic — your WeCom email plus an app-specific CalDAV password from the WeCom mobile app (Workbench → Calendar → settings → Sync to other calendars). Fetching a new one invalidates the previous.

Quick start

Sync once, then work the calendar

Configure a server, sync into the local store, then query and annotate.

a typical session

# configure, then verify connectivity
$ wecom-calendar-cli config init
$ wecom-calendar-cli doctor

# pull calendars + events into the local store, then query a window
$ wecom-calendar-cli sync
$ wecom-calendar-cli event list --since 2026-07-01 --until 2026-07-31

# annotate an event (uid from an event-list item) and link it to a task
$ wecom-calendar-cli meta set <uid> task feishu_project "6949886165" --source agent
$ wecom-calendar-cli meta get <uid>

Commands

The command surface

Sync, query, annotate — plus the family's setup and diagnostics. Every flag and example lives in the full CLI reference.

sync

Pull CalDAV changes into the local store — incremental, idempotent, with --full and --dry-run.

calendar

List calendars from the store, or re-list from the server with --refresh.

event

Query events in a --since/--until window.