apple-calendar

--- name: apple-calendar description: Read and write the user's Apple (iCloud) Calendar over CalDAV. Use for checking the schedule / free-busy, and creating, updating, or deleting events. --- # Apple Calendar (iCloud, CalDAV) A Node script talks to iCloud CalDAV using `APPLE_ID` + `APPLE_APP_PASSWORD` from the environment (sealed into `wicek-secrets`). All output is JSON on stdout. Invoke: ``` node /app/.claude/skills/apple-calendar/cal.mjs <command> [--flags] ``` Commands: - `list-calendars` — list calendars (`name`, `url`, `components`). - `list-events --from <ISO> --to <ISO> [--calendar <name>]` — events in a time range; recurring events are expanded to individual occurrences. Defaults to all event-capable calendars. - `create-event --summary <s> --start <ISO> --end <ISO> [--calendar <name>] [--location <l>] [--description <d>]` — create an event. Date-only `--start`/`--end` (e.g. `2026-06-01`) makes an all-day event. - `update-event --url <obj-url> --etag <etag> [--summary ...] [--start ...] [--end ...] [--location ...] [--description ...]` — modify an event; `url` and `etag` come from `list-events`. - `delete-event --url <obj-url> [--etag <etag>]` — delete an event. Notes: - Times are ISO 8601, e.g. `2026-06-01T09:00:00Z`. Prefer explicit UTC/offsets. - For "what's on my calendar today", compute today's start/end and call `list-events`. - This is the user's real calendar – for ambiguous create/update/delete, confirm intent first.