A command-line interface for macOS that enables AI agents to programmatically manage Apple Calendar events using EventKit and structured JSON.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install apple-calendar-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 apple-calendar-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 Apple Calendar CLI?
The Apple Calendar CLI is a specialized tool designed to provide AI agents with direct access to the macOS Calendar system. By leveraging the native EventKit framework, it allows for the seamless management of local and iCloud-synced calendars. This utility is a vital component for those building automated workflows within the ecosystem of Openclaw Skills, offering a bridge between natural language instructions and system-level scheduling.
Built for macOS 14 and later, the tool ensures that agents can interact with schedules using a reliable, machine-readable format. It handles complex calendar logic, including timezone-aware ISO 8601 dates and recurrence rules, making it an ideal choice for developers who need to integrate high-fidelity scheduling capabilities into their Openclaw Skills projects.
Apple Calendar CLI Use Cases
- Automatically rescheduling meetings based on new priority tasks.
- Synchronizing project deadlines from a CLI environment to a personal macOS calendar.
- Fetching daily agendas to provide morning briefings via an AI agent.
- Creating recurring team standups with specific alerts and attendee lists.
- Searching for specific events across multiple calendars to identify scheduling conflicts.
How Apple Calendar CLI Works
- The tool interfaces with the macOS EventKit API to access the system's calendar database.
- Users or agents invoke specific commands like list-events or create-event with the --json flag to ensure structured data exchange.
- The CLI validates ISO 8601 date inputs to ensure consistency across different timezones and formats.
- For write operations, the tool requests permission from the macOS Privacy & Security settings to modify calendar entries.
- The agent receives a JSON response containing unique identifiers, which are used for subsequent updates or deletions.
Apple Calendar CLI Setup
To integrate this tool into your Openclaw Skills environment, ensure you are on macOS 14+ and use Homebrew for installation:
brew install sichengchen/tap/apple-calendar-cli
After installation, you must manually grant Calendar access in System Settings > Privacy & Security > Calendars. Verify the installation by checking the version:
apple-calendar-cli --version
Apple Calendar CLI Data Schema & Taxonomy
The skill produces structured JSON objects for both calendars and events. The schema is optimized for programmatic parsing by Openclaw Skills.
Event Object Schema
| Field | Type | Description |
|---|---|---|
| identifier | String | Unique ID used for event retrieval and updates |
| title | String | The summary or name of the event |
| startDate | String | ISO 8601 start date (e.g., 2026-02-22T10:00:00-08:00) |
| endDate | String | ISO 8601 end date |
| calendarTitle | String | The name of the calendar the event belongs to |
| location | String | Optional physical or virtual location |
| notes | String | Optional description or metadata |
Apple Calendar CLI Advanced Features
- Support for complex recurrence rules including daily, weekly, monthly, and yearly frequencies.
- Automated alert triggers with configurable offsets such as 15 minutes or 1 hour before events.
- Full attendee management using comma-separated email addresses for event invitations.
- Multi-calendar filtering using unique calendar identifiers to isolate work, personal, or shared schedules.
- Deep integration with iCloud, CalDAV, and local macOS account sources.
SKILL.md
Loading
Related Openclaw Skills
1Password CLI for Agents
A powerful skill enabling AI agents to securely read, write, and manage secrets via the 1Password CLI and Service Accounts.
OpenClaw Knowledge Coach
An intelligent local knowledge assistant that imports documents into OpenClaw and automatically generates retrieval practice exercises to improve memory retention.
Gardening Calendar
A sophisticated horticultural intelligence skill that provides precise, localized sowing and harvesting schedules for over 160 plant varieties.
Apple Serial Lookup
A comprehensive utility to identify Apple hardware specifications, manufacturing details, and model identifiers from a serial number.
Ohio State University API Skill
A comprehensive interface to fetch public data from The Ohio State University Content APIs, including transit, dining, and academic resources.
Ringg Voice Agent
A high-performance voice automation skill that enables Openclaw agents to make, manage, and analyze AI-powered phone calls via Ringg AI.
Featured*
