A command-line interface for macOS that provides high-speed access to Apple Calendar events using icalBuddy and AppleScript.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install calctl
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 calctl 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 calctl?
calctl is a technical utility designed for users who need to interact with their Apple Calendar directly from the terminal. As part of the ecosystem of Openclaw Skills, it provides a bridge between native macOS scheduling and developer-centric workflows. It utilizes the speed of icalBuddy for reading calendar data and the reliability of AppleScript for writing new events, ensuring a seamless experience for managing personal and professional time.
calctl Use Cases
- Rapidly viewing daily agendas or weekly schedules without leaving the terminal environment.
- Automating event creation for meetings, standups, or reminders via CLI scripts.
- Searching for specific historical or upcoming appointments within a rolling 30-day window.
- Managing multiple distinct calendars such as Work, Private, and Family from a single interface.
How calctl Works
- The user inputs a calctl command followed by specific arguments for filtering or event details.
- For read operations, the skill triggers icalBuddy to fetch and format calendar data for the terminal output.
- For write operations, such as adding an event, the skill translates the input parameters into an AppleScript execution.
- The system updates the native macOS Calendar app in the background, ensuring data remains synchronized across all Apple devices.
calctl Setup
To utilize this functionality within Openclaw Skills, you must first install the required dependency using Homebrew:
brew install ical-buddy
Once installed, the calctl command becomes available for managing your local calendars.
calctl Data Schema & Taxonomy
The skill processes calendar data using a structured schema to ensure compatibility with native macOS event formats:
| Field | Type | Description |
|---|---|---|
| calendar | String | The target calendar name (e.g., Work, Privat) |
| date | ISO 8601 | The date of the event in YYYY-MM-DD format |
| time | HH:MM | The start and end times for the event |
| notes | Text | Descriptive metadata or reminders attached to the event |
| all-day | Boolean | Flag for events without specific time constraints |
calctl Advanced Features
- Context-aware filtering allowing for relative time queries like today, tomorrow, or week.
- Multi-calendar support for isolating events between professional and personal accounts.
- Detailed event customization including duration control and note injection.
- Integrated search capability optimized for finding events in the near-term future.
SKILL.md
Loading
Related Openclaw Skills
Bilibili Video Analyzer
An automated tool for converting Bilibili educational content into structured, clean-style study notes with AI-driven insights and visual aids.
Talking Circle AI Video Generator
A specialized tool for Openclaw Skills that converts text or audio into animated circular avatar videos with automated lip-sync and blink cycles.
Telegram Inline Buttons
A specialized skill for implementing interactive inline keyboards in Telegram to streamline agent-to-human decision-making and confirmations.
Self-Improvement Skill
A systematic framework for AI agents to log errors, user corrections, and new insights to enable continuous self-optimization.
notectl
A command-line interface for managing Apple Notes via AppleScript, enabling seamless note manipulation from the terminal.
Zettelkasten AI Note-Taking
An AI-enhanced implementation of the Zettelkasten method for intelligent knowledge management and discovery.
Featured*
