SkillHub

apple-calendar-pro

v1.3.0

iCloud Calendar skill via CalDAV (RFC 4791) — works on macOS/Linux, and Windows with env/keyring auth. Supports event CRUD, multi-calendar queries, managed attachments (RFC 8607), and free/busy lookups.

Sourced from ClawHub, Authored by Xushen

Installation

Please help me install the skill `apple-calendar-pro` from SkillHub official store. npx skills add xushen-ma/apple-calendar-pro

apple-calendar-pro

Advanced Apple Calendar integration using CalDAV (RFC 4791) and Managed Attachments (RFC 8607).

Primary CLI

scripts/applecal.py

Capabilities

  • Event CRUD: List, Create, Update, Delete.
  • Multi-Calendar Support: Query multiple calendars in a single command.
  • True Attachments: RFC 8607 compatible (works on iPhone/iPad).
  • Free/Busy: CalDAV scheduling lookup with event-derived fallback.

Common Commands

List Events (Combined)

Check multiple calendars at once:

python3 scripts/applecal.py events list 
  --apple-id [email protected] 
  --calendar Family 
  --calendar Work 
  --from "2026-02-26T00:00:00Z" 
  --to "2026-02-26T23:59:59Z"

Create All-Day Event

python3 scripts/applecal.py events create 
  --apple-id [email protected] 
  --calendar Family 
  --summary "Birthday" 
  --start "2026-02-26" 
  --end "2026-02-26" 
  --all-day

Attach a File (iPhone Safe)

python3 scripts/applecal.py attach add 
  --apple-id [email protected] 
  --calendar Family 
  --uid <UID> 
  --file /path/to/document.pdf

Free/Busy Check

python3 scripts/applecal.py freebusy 
  --apple-id [email protected] 
  --calendar Family 
  --from "2026-02-26T00:00:00Z" 
  --to "2026-02-26T23:59:59Z"

Notes

  • Birthdays: The virtual "Birthdays" calendar is not searchable via CalDAV. Key birthdays should be added as physical recurring events in the Family calendar for agent visibility.
  • Auth: Resolution order is APPLECAL_PASSWORD → Python keyring (if installed/configured) → macOS Keychain fallback. Run doctor to verify connectivity.
  • Event update clearing: Use events update --clear-location / --clear-description to explicitly remove optional fields.
  • Attachment safety: attach add blocks sensitive paths/names, allowlists file extensions, and supports optional directory scoping via APPLECAL_ATTACH_DIR.
  • Apple ID: Always pass --apple-id [email protected] (the iCloud account email, not necessarily your Apple ID login).