apple-calendar-cli

Apple Calendar CLI — Agent Skill

You have access to apple-calendar-cli, a command-line tool for managing Apple Calendar events via EventKit on macOS.

Prerequisites

• macOS 14+ required
• Install: brew install sichengchen/tap/apple-calendar-cli
• Calendar access permission must be granted (System Settings > Privacy & Security > Calendars)

Date Format

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

Global Options

• --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.

Commands

list-calendars

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

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:00Z",
    "endDate": "2026-02-22T10:30:00Z",
    "isAllDay": false,
    "location": "Conference Room A",
    "notes": null,
    "calendarTitle": "Work",
    "calendarIdentifier": "CALENDAR-ID",
    "url": null,
    "hasRecurrenceRules": true
  }
]