This skill should be used when interacting with Apple Calendar on macOS. Use it for listing calendars, viewing events, creating/updating/deleting calendar events, and checking availability/free-busy times. Triggers on requests like "check my calendar", "schedule a meeting", "what's on my schedule", "am I free tomorrow", or any calendar-related operations.
```bash
npm install -g @joargp/accli
```
**Requirements:** macOS only (uses JavaScript for Automation)
The accli tool provides command-line access to macOS Apple Calendar. It enables listing calendars, querying events, creating/updating/deleting events, and checking availability across calendars.
```
accli calendars [--json]
```
Lists all available calendars with names and persistent IDs. Run this first to discover available calendars and their IDs.
```
accli events <calendarName> [options]
```
Options:
Examples:
```bash
accli events Work --json
accli events Work --from 2025-01-01 --to 2025-01-31 --json
accli events Work --query "standup" --max 10 --json
```
```
accli event <calendarName> <eventId> [--json]
```
Retrieves details for a specific event by its ID.
```
accli create <calendarName> --summary <s> --start <datetime> --end <datetime> [options]
```
Required Options:
Optional:
Examples:
```bash
accli create Work --summary "Team Standup" --start 2025-01-15T09:00 --end 2025-01-15T09:30 --json
accli create Personal --summary "Vacation" --start 2025-07-01 --end 2025-07-05 --all-day --json
accli create Work --summary "Client Meeting" --start 2025-01-15T14:00 --end 2025-01-15T15:00 \
--location "Conference Room A" --description "Q1 planning discussion" --json
```
```
accli update <calendarName> <eventId> [options]
```
Options (all optional - only provide what to change):
Example:
```bash
accli update Work event-id-123 --summary "Updated Meeting Title" --start 2025-01-15T15:00 --end 2025-01-15T16:00 --json
```
```
accli delete <calendarName> <eventId> [--json]
```
Permanently deletes an event. Confirm with user before executing.
```
accli freebusy --calendar <name> --from <datetime> --to <datetime> [options]
```
Options:
Shows busy time slots, excluding cancelled, declined, and transparent events.
Examples:
```bash
accli freebusy --calendar Work --calendar Personal --from 2025-01-15 --to 2025-01-16 --json
accli freebusy --calendar Work --from 2025-01-15T09:00 --to 2025-01-15T18:00 --json
```
```bash
accli config set-default
accli config set-default --calendar Work
accli config show
accli config clear
```
When a default calendar is set, commands automatically use it if no calendar is specified.
1. List calendars to get available calendar names/IDs
2. Check free/busy to find available time slots
3. Confirm event details with user before creating
Find a free slot and schedule:
```bash
accli freebusy --calendar Work --from 2025-01-15T09:00 --to 2025-01-15T18:00 --json
accli create Work --summary "Meeting" --start 2025-01-15T14:00 --end 2025-01-15T15:00 --json
```
View today's schedule:
```bash
accli events Work --from $(date +%Y-%m-%d) --to $(date -v+1d +%Y-%m-%d) --json
```
Leave a review
No reviews yet. Be the first to review this skill!