accli

---
name: accli
description: 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.
---

# Apple Calendar CLI (accli)

## Installation

```bash
npm install -g @joargp/accli
```

**Requirements:** macOS only (uses JavaScript for Automation)

## Overview

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.

## Quick Reference

### DateTime Formats
- Timed events: YYYY-MM-DDTHH:mm or YYYY-MM-DDTHH:mm:ss
- All-day events: YYYY-MM-DD

### Global Options
- --json - Output as JSON (recommended for parsing)
- --help - Show help for any command

## Commands

### List Calendars

```
accli calendars [--json]
```

Lists all available calendars with names and persistent IDs. Run this first to discover available calendars and their IDs.

### List Events

```
accli events <calendarName> [options]
```

Options:
- --calendar-id <id> - Persistent calendar ID (recommended over name)
- --from <datetime> - Start of range (default: now)
- --to <datetime> - End of range (default: from + 7 days)
- --max <n> - Maximum events to return (default: 50)
- --query <q> - Case-insensitive filter on summary/location/description
- --json - Output JSON

Examples:

```bash
# Events from Work calendar for this week
accli events Work --json

# Events in January
accli events Work --from 2025-01-01 --to 2025-01-31 --json

# Search for specific events
accli events Work --query "standup" --max 10 --json
```

### Get Single Event

```
accli event <calendarName> <eventId> [--json]
```

Retrieves details for a specific event by its ID.

### Create Event

```
accli create <c