A high-performance Go-based CLI for complete CRUD operations on macOS Calendar using natural language and machine-readable outputs.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ical-cli
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install ical-cli 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 Cal-CLI: macOS Calendar Command Line Interface?
Cal-CLI is a sophisticated terminal utility designed for developers and power users who need to interact with the native Apple Calendar app without leaving their command line. Built with Go and leveraging cgo for direct EventKit integration, it offers sub-millisecond read speeds and a robust set of features for managing events and calendars. As a core component of the Openclaw Skills library, it enables seamless calendar automation and integration into larger developer workflows and AI-driven environments.
Cal-CLI: macOS Calendar Command Line Interface Use Cases
- Automating meeting creation and management via shell scripts or AI agents.
- Conducting daily or weekly schedule reviews directly from the terminal without opening a GUI.
- Bulk exporting calendar data to JSON, CSV, or ICS for backups and external data analysis.
- Integrating calendar management into customized Openclaw Skills workflows for enhanced productivity.
- Rapidly searching through years of calendar history using flexible natural language search parameters.
How Cal-CLI: macOS Calendar Command Line Interface Works
- The CLI initializes by establishing a high-performance connection to the macOS EventKit framework via cgo.
- Users issue commands like list or add using natural language date processing (e.g., tomorrow at 9am).
- The tool generates a cached list of events with row numbers for easy subsequent referencing in commands like show, update, or delete.
- All changes are committed directly to the local macOS Calendar database, ensuring instant synchronization across all synced Apple devices.
- For programmatic automation, the tool provides structured JSON output to pipe data into other Openclaw Skills or command-line utilities.
Cal-CLI: macOS Calendar Command Line Interface Setup
To install this tool as part of your Openclaw Skills toolkit, use the Go command:
go install github.com/BRO3886/ical/cmd/ical@latest
Alternatively, you can build it from source if you have Xcode Command Line Tools installed:
git clone <repo-url> && cd ical
make build
To enable the agent-specific features, run:
ical skills install
Cal-CLI: macOS Calendar Command Line Interface Data Schema & Taxonomy
Cal-CLI organizes data into two primary structures: Calendars and Events. Metadata is cached locally to facilitate row-based referencing.
| Entity | Key Fields | Metadata Included |
|---|---|---|
| Calendar | id, title, type, color, source, readOnly | Source provider and hex color codes |
| Event | id, title, start_date, end_date, location, notes, url | Recurrence rules and multiple alert triggers |
Machine-readable output is available via the --output json flag, providing ISO 8601 timestamps and unique identifiers suitable for Openclaw Skills integration.
Cal-CLI: macOS Calendar Command Line Interface Advanced Features
- Full support for complex recurrence rules including daily, weekly, and monthly patterns with interval controls.
- Multiple alert configurations per event using time-based triggers like 15m, 1h, or 1d before the start time.
- Advanced natural language date parsing that understands phrases like next Friday or 2 days ago.
- Interactive mode using the -i flag for guided multi-page form input when creating or updating events.
- Row number caching mechanism that allows users to reference events by simple integers instead of long UUIDs.
- Native support for Openclaw Skills protocols to allow AI agents to manage calendars autonomously.
SKILL.md
Loading
Related Openclaw Skills
healthsync
healthsync is a specialized tool for querying Apple Health export data stored in a local SQLite database using AI agents.
Multi-Task: Parallel Batch Orchestration
A powerful orchestration skill that enables parallel execution of repetitive batch tasks by dispatching work to multiple subagents simultaneously.
RealWorldClaw
RealWorldClaw empowers AI agents to sense and act in the physical world by controlling ESP32 hardware and reading real-time sensor data.
Voice-Matched Content
A professional framework for extracting authentic writing styles to generate AI content that sounds human rather than robotic.
rem
A high-performance Go-based CLI for macOS Reminders that enables fast task management via the terminal or AI agents.
Overkill Token Optimizer
An efficiency-focused utility for Openclaw Skills designed to minimize token consumption through output compression and intelligent session indexing.
Featured*
