Apple Calendar CLI (accli) for Openclaw

A command-line interface for managing Apple Calendar events and availability on macOS.

joargp
v1.0.0
Jan 6, 2026
11
7.3k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install accli

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install accli using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Apple Calendar CLI (accli)?

The Apple Calendar CLI (accli) is a powerful tool designed for macOS users to interact with their native calendar application directly from the terminal or through automated agents. As part of the Openclaw Skills ecosystem, it allows AI agents and developers to list calendars, query events, and manage schedules with precision.

It leverages JavaScript for Automation (JXA) to provide a deep, native integration with the macOS system. By using this skill, users can bridge the gap between their local calendar data and automated AI workflows. This Openclaw Skills integration is perfect for those who want to automate their daily planning, sync schedules, or build custom productivity tools without leaving their terminal environment.

Apple Calendar CLI (accli) Use Cases

  • Scheduling meetings and events via simple text prompts to an AI agent.
  • Checking daily availability and free-busy slots across multiple macOS calendars simultaneously.
  • Automating calendar cleanup by deleting or updating outdated events.
  • Fetching agenda summaries for specific projects or date ranges using case-insensitive search queries.

How Apple Calendar CLI (accli) Works

  1. The user or AI agent invokes the accli command to list available calendars and identify the correct persistent IDs.
  2. The tool queries the macOS Calendar database using native automation protocols to retrieve events or check availability for specific time ranges.
  3. Based on the output, the user can create, update, or delete events by passing parameters like summary, start time, and location.
  4. The skill returns structured JSON data for every operation, allowing for programmatic parsing and sophisticated logic within the Openclaw Skills framework.

Apple Calendar CLI (accli) Setup

To get started with this skill, ensure you are on a macOS machine and run the following command to install the CLI globally:

npm install -g @joargp/accli

After installation, you may need to grant your terminal or IDE the necessary permissions to access Calendar data in macOS System Settings. You can verify the installation and set your default calendar by running:

accli config set-default

Apple Calendar CLI (accli) Data Schema & Taxonomy

The skill primarily operates with calendar and event objects, returning data in structured JSON format when the --json flag is enabled. This is the recommended format for Openclaw Skills integrations.

Property Type Description
id String Persistent identifier for the calendar or event.
summary String The title or headline of the calendar event.
start ISO 8601 The starting timestamp (e.g., YYYY-MM-DDTHH:mm).
end ISO 8601 The ending timestamp of the event.
location String Optional physical or virtual location details.
description String Detailed notes or description of the event.

Apple Calendar CLI (accli) Advanced Features

  • Multi-calendar free/busy checks to find open slots across Work, Personal, and Shared calendars.
  • Persistent configuration settings to define default calendars, reducing the need for repetitive arguments.
  • Support for both timed and all-day events using flexible ISO 8601 date-time formatting.
  • Advanced filtering capabilities that allow searching for events by query strings across summary, location, and description fields.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*