Skill

accli

From sundial-org-awesome-openclaw-skills-4

Provides CLI access to macOS Apple Calendar for listing calendars, querying events, and creating/updating/deleting events. Useful for calendar management via terminal.

automation

cli-tools

Popularity

Stars

626

Forks

Invocation

How this skill is triggered — by the user, by Claude, or both

Slash command

/sundial-org-awesome-openclaw-skills-4:accli

User invocable

Model invocable

Inline context

Default effort

Context Preview

The summary Claude sees in its skill listing — used to decide when to auto-load this skill

```bash

SKILL.md

210 lines · ~1.4k tokens

Stats

LanguagePython

Stars626

Forks88

MaintenancePoor

Last CommitMar 7, 2026

Actions

View Source View Plugin View on GitHub View README

Apple Calendar CLI (accli)

Installation

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

Examples:

# 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 <calendarName> --summary <s> --start <datetime> --end <datetime> [options]

Required Options:

--summary ~~- Event title~~

--start - Start time

--end - End time

Optional:

--location - Event location

--description - Event description

--all-day - Create an all-day event

--json - Output JSON

Examples:

# Create a timed meeting accli create Work --summary "Team Standup" --start 2025-01-15T09:00 --end 2025-01-15T09:30 --json # Create an all-day event accli create Personal --summary "Vacation" --start 2025-07-01 --end 2025-07-05 --all-day --json # Create with location and description 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

Update Event

accli update <calendarName> <eventId> [options]

Options (all optional - only provide what to change):

--summary ~~- New title~~

--start - New start time

--end - New end time

--location - New location

--description - New description

--all-day - Convert to all-day event

--no-all-day - Convert to timed event

--json - Output JSON

Example:

accli update Work event-id-123 --summary "Updated Meeting Title" --start 2025-01-15T15:00 --end 2025-01-15T16:00 --json

Delete Event

accli delete <calendarName> <eventId> [--json]

Permanently deletes an event. Confirm with user before executing.

Check Free/Busy

accli freebusy --calendar <name> --from <datetime> --to <datetime> [options]

Options:

--calendar - Calendar name (can repeat for multiple calendars)

--calendar-id - Persistent calendar ID (can repeat)

--from - Start of range (required)

--to - End of range (required)

--json - Output JSON

Shows busy time slots, excluding cancelled, declined, and transparent events.

Examples:

# Check availability across calendars accli freebusy --calendar Work --calendar Personal --from 2025-01-15 --to 2025-01-16 --json # Check specific hours accli freebusy --calendar Work --from 2025-01-15T09:00 --to 2025-01-15T18:00 --json

Configuration

# Set default calendar (interactive) accli config set-default # Set default by name accli config set-default --calendar Work # Show current config accli config show # Clear default accli config clear

When a default calendar is set, commands automatically use it if no calendar is specified.

Workflow Guidelines

Before Creating Events

List calendars to get available calendar names/IDs

Check free/busy to find available time slots

Confirm event details with user before creating

Best Practices

Always use --json flag for programmatic parsing

Prefer --calendar-id over calendar names for reliability

When querying events, start with reasonable date ranges

Confirm with user before delete operations

Use ISO 8601 datetime format consistently

Common Patterns

Find a free slot and schedule:

# 1. Check availability accli freebusy --calendar Work --from 2025-01-15T09:00 --to 2025-01-15T18:00 --json # 2. Create event in available slot accli create Work --summary "Meeting" --start 2025-01-15T14:00 --end 2025-01-15T15:00 --json

View today's schedule:

accli events Work --from $(date +%Y-%m-%d) --to $(date -v+1d +%Y-%m-%d) --json

accli

Popularity

Invocation

Context Preview

SKILL.md

accli

Popularity

Invocation

Context Preview

SKILL.md

Apple Calendar CLI (accli)

Installation

Overview

Quick Reference

DateTime Formats

Global Options

Commands

List Calendars

List Events

Get Single Event

Create Event

Update Event

Delete Event

Check Free/Busy

Configuration

Workflow Guidelines

Before Creating Events

Best Practices

Common Patterns

Similar Skills

Apple Calendar CLI (accli)

Installation

Overview

Quick Reference

DateTime Formats

Global Options

Commands

List Calendars

List Events

Get Single Event

Create Event

Update Event

Delete Event

Check Free/Busy

Configuration

Workflow Guidelines

Before Creating Events

Best Practices

Common Patterns

Similar Skills