Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Manage Apple Calendar events on macOS 14+ using apple-calendar-cli: list, get, create, update, and delete events with ISO 8601 date support.
Manage Apple Calendar events on macOS 14+ using apple-calendar-cli: list, get, create, update, and delete events with ISO 8601 date support.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
You have access to apple-calendar-cli, a command-line tool for managing Apple Calendar events via EventKit on macOS.
macOS 14+ required Install: brew install sichengchen/tap/apple-calendar-cli Calendar access permission must be granted (System Settings > Privacy & Security > Calendars)
All dates use ISO 8601 format: Date only: YYYY-MM-DD (interpreted as start of day in local timezone) Date and time: YYYY-MM-DDTHH:MM:SS (local timezone) Full ISO 8601: YYYY-MM-DDTHH:MM:SSZ or with offset
--json โ Output results as structured JSON (available on all commands) --version โ Show version --help / -h โ Show help Always use --json when calling from an agent for reliable parsing.
List all available calendars. apple-calendar-cli list-calendars --json JSON output โ array of objects: [ { "identifier": "CALENDAR-ID", "title": "Work", "type": "calDAV", "source": "iCloud", "color": "#1BADF8", "isImmutable": false } ] Use identifier to filter events or target a specific calendar when creating events.
List events within a date range. apple-calendar-cli list-events --json apple-calendar-cli list-events --from 2026-02-22 --to 2026-02-28 --json apple-calendar-cli list-events --from 2026-02-22 --to 2026-02-28 --calendar CALENDAR-ID --json Options: --from โ Start date (default: today) --to โ End date (default: 7 days from start) --calendar โ Filter by calendar identifier JSON output โ array of event objects: [ { "identifier": "EVENT-ID", "title": "Team standup", "startDate": "2026-02-22T10:00:00-08:00", "endDate": "2026-02-22T10:30:00-08:00", "isAllDay": false, "location": "Conference Room A", "notes": null, "calendarTitle": "Work", "calendarIdentifier": "CALENDAR-ID", "url": null, "hasRecurrenceRules": true } ]
Get full details of a single event. apple-calendar-cli get-event EVENT-ID --json JSON output โ single event object (same schema as list-events items).
Create a new calendar event. apple-calendar-cli create-event \ --title "Meeting with Alice" \ --start "2026-02-23T14:00:00" \ --end "2026-02-23T15:00:00" \ --json apple-calendar-cli create-event \ --title "All-day conference" \ --start "2026-03-01" \ --end "2026-03-02" \ --all-day \ --calendar CALENDAR-ID \ --location "Convention Center" \ --notes "Bring laptop" \ --url "https://example.com/conf" \ --json Required options: --title โ Event title --start โ Start date/time --end โ End date/time (must be after start) Optional options: --calendar โ Calendar identifier (default: system default calendar) --notes โ Event notes --location โ Event location --all-day โ Mark as all-day event --url โ Event URL --recurrence โ Recurrence rule: daily, weekly, monthly, yearly --recurrence-end โ End date for recurrence --recurrence-count โ Number of occurrences --attendees โ Comma-separated email addresses --alert โ Alert offset (e.g., 15m, 1h, 1d) JSON output โ the created event object with its new identifier.
Update an existing event (partial update โ only specified fields change). apple-calendar-cli update-event EVENT-ID --title "New title" --json apple-calendar-cli update-event EVENT-ID \ --start "2026-02-23T15:00:00" \ --end "2026-02-23T16:00:00" \ --location "Room B" \ --json Required argument: <id> โ Event identifier Optional options: --title โ New title --start โ New start date/time --end โ New end date/time --calendar โ Move to different calendar (by identifier) --notes โ New notes --location โ New location --url โ New URL JSON output โ the updated event object.
Delete a calendar event. apple-calendar-cli delete-event EVENT-ID --json JSON output: { "deleted": true, "event": { ... } }
# 1. List events to find the one to reschedule apple-calendar-cli list-events --from 2026-02-22 --to 2026-02-28 --json # 2. Get full details apple-calendar-cli get-event EVENT-ID --json # 3. Update the time apple-calendar-cli update-event EVENT-ID \ --start "2026-02-24T14:00:00" \ --end "2026-02-24T15:00:00" \ --json
# 1. List calendars to find the right one apple-calendar-cli list-calendars --json # 2. Create the event on that calendar apple-calendar-cli create-event \ --title "Dentist" \ --start "2026-02-25T09:00:00" \ --end "2026-02-25T10:00:00" \ --calendar CALENDAR-ID \ --json
Date-only values resolve to midnight (00:00:00), so --to must be the next day to cover the full day: # Correct: covers 2026-02-22 00:00 to 2026-02-23 00:00 apple-calendar-cli list-events --from 2026-02-22 --to 2026-02-23 --json
Calendar access denied: User needs to grant access in System Settings > Privacy & Security > Calendars Event not found: The event ID may be stale โ list events again to get current IDs Invalid date format: Use ISO 8601 (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS) End before start: Ensure the end date/time is after the start date/time
Workflow acceleration for inboxes, docs, calendars, planning, and execution loops.
Largest current source with strong distribution and engagement signals.