✓ Verified 💻 Development ✓ Enhanced Data

Accli

This skill should be used when interacting with Apple Calendar on macOS.

Rating
4.4 (19 reviews)
Downloads
1,004 downloads
Version
1.0.0

Overview

This skill should be used when interacting with Apple Calendar on macOS.

Complete Documentation

View Source →

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

text
accli calendars [--json]

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

List Events

text
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:

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

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

Retrieves details for a specific event by its ID.

Create Event

text
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:

bash
# 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

text
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:

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

Delete Event

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

Permanently deletes an event. Confirm with user before executing.

Check Free/Busy

text
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:

bash
# 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

bash
# 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:

bash
# 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:

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

Installation

Terminal bash 

openclaw install accli
Copied!

💻Code Examples

npm install -g @joargp/accli

npm-install--g-joargpaccli.txt
**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]

accli-calendars---json.txt
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]

accli-events-calendarname-options.txt
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:

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

accli-event-calendarname-eventid---json.txt
Retrieves details for a specific event by its ID.

### Create Event

accli create <calendarName> --summary <s> --start <datetime> --end <datetime> [options]

accli-create-calendarname---summary-s---start-datetime---end-datetime-options.txt
Required Options:
- --summary <s> - Event title
- --start <datetime> - Start time
- --end <datetime> - End time

Optional:
- --location <l> - Event location
- --description <d> - Event description
- --all-day - Create an all-day event
- --json - Output JSON

Examples:

accli update <calendarName> <eventId> [options]

accli-update-calendarname-eventid-options.txt
Options (all optional - only provide what to change):
- --summary <s> - New title
- --start <datetime> - New start time
- --end <datetime> - New end time
- --location <l> - New location
- --description <d> - New description
- --all-day - Convert to all-day event
- --no-all-day - Convert to timed event
- --json - Output JSON

Example:

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

accli-delete-calendarname-eventid---json.txt
Permanently deletes an event. Confirm with user before executing.

### Check Free/Busy

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

accli-freebusy---calendar-name---from-datetime---to-datetime-options.txt
Options:
- --calendar <name> - Calendar name (can repeat for multiple calendars)
- --calendar-id <id> - Persistent calendar ID (can repeat)
- --from <datetime> - Start of range (required)
- --to <datetime> - End of range (required)
- --json - Output JSON

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

Examples:

accli config clear

accli-config-clear.txt
When a default calendar is set, commands automatically use it if no calendar is specified.

## Workflow Guidelines

### Before Creating Events
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

### 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:
example.sh
# 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

Tags

#calendar_and-scheduling #cli

Quick Info

Category Development
Model Claude 3.5
Complexity One-Click
Author joargp
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install accli

Resources

📂
OpenClaw Skills
View on OpenClaw GitHub
→

Related Skills

✓ Verified 💻 Development

4claw

4claw — a moderated imageboard for AI agents.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.4 (118)
↓ 4,990
v1.0.0
✓ Verified 💻 Development

Aap Passport

Agent Attestation Protocol - The Reverse Turing Test.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.3 (89)
↓ 4,621
v1.0.0
✓ Verified 💻 Development

Acestep Lyrics Transcription

Transcribe audio to timestamped lyrics using OpenAI Whisper or ElevenLabs Scribe API.

⚡ GPT-Optimized #ai_and-llms #api #script
)}
★ 3.8 (274)
↓ 17,648
v1.0.0
✓ Verified 💻 Development

Adaptive Suite

A continuously adaptive skill suite that empowers Clawdbot.

🧠 Claude-Ready #ai_and-llms #bot
)}
★ 4.7 (88)
↓ 1,625
v1.0.0