accli

What This Skill Does

The accli skill acts as a bridge between the OpenClaw AI agent and your native Apple Calendar application on macOS. By leveraging JavaScript for Automation (JXA), it provides a powerful command-line interface to manage your schedule without opening the Calendar GUI. You can list calendars, retrieve event details, create new entries, modify existing schedules, or delete events entirely. Whether you are looking to audit your time, search for specific meeting metadata, or quickly block off time in your day, accli offers a programmatic and efficient way to maintain your productivity ecosystem.

Installation

To begin using this skill, ensure you have Node.js installed on your macOS machine. Open your terminal and run the following command to install the CLI package globally:

npm install -g @joargp/accli

Once installed, OpenClaw will automatically detect the tool. Note that this skill is strictly exclusive to macOS environments due to its underlying dependency on Apple's automation frameworks.

Use Cases

accli is ideal for professionals who need to manage time across multiple calendar accounts (Work, Personal, Shared). It is particularly effective for automating scheduling workflows, such as checking your availability before confirming a meeting or syncing external task lists with your calendar events. Because it supports JSON output, it is perfect for data-driven users who want to pipe calendar information into other scripts or dashboards.

Example Prompts

1. "Check my Work calendar for any meetings scheduled between 9 AM and 5 PM today."
2. "Schedule a 'Project Sync' meeting for tomorrow at 2 PM for one hour in the main conference room."
3. "Am I free this Thursday afternoon, or do I have any conflicting appointments?"

Tips & Limitations

• Identifiers: Always prefer using the persistent calendar ID when performing operations like updating or deleting events, as calendar names may be duplicated or ambiguous.
• Date Formats: Stick to the ISO-like format (YYYY-MM-DDTHH:mm) to ensure the engine correctly parses your start and end times.
• JSON Output: Always use the --json flag when invoking commands through OpenClaw to ensure the agent receives machine-readable data, which significantly improves accuracy and reduces parsing errors.
• Scope: This tool is limited to the calendars currently configured in your local macOS Calendar app. It does not provide access to calendars not synced to your system account.