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.

1. **Enable CalDAV Access**: Ensure your Apple Calendar is synced with iCloud and CalDAV is enabled in your iCloud account settings. Go to *Settings > [Your Name] > iCloud > Calendar* to verify. 2. **Authenticate the AI**: Provide your iCloud credentials or API key (if using an app-specific token) to grant the AI access to your calendar. Use apps like *Shortcuts* or *Calendar* integrations for secure authentication. 3. **Run the Prompt**: Copy the prompt template into your AI tool (e.g., ChatGPT, Claude) and replace [PLACEHOLDERS] with your specific details. For bulk operations, list multiple events or dates. 4. **Review and Confirm**: Check the AI’s output for accuracy. If creating or updating events, double-check the details before finalizing. 5. **Sync Changes**: Ensure your calendar app (e.g., Apple Calendar, Outlook) is set to auto-sync to reflect the AI’s changes in real-time. **Tips**: - For sensitive operations (e.g., deleting events), add a confirmation step: "Ask for my confirmation before deleting any event." - Use specific time zones (e.g., "10:00 AM PDT") to avoid ambiguity. - Test with a single event first to ensure the AI’s actions align with your expectations.