← Back to Skills Marketplace
Options for
2664
Downloads
1
Stars
11
Active Installs
1
Versions
Install in OpenClaw
/install calctl
Description
Manage Apple Calendar events via icalBuddy + AppleScript CLI
README (SKILL.md)
calctl - Apple Calendar CLI
Manage Apple Calendar from the command line using icalBuddy (fast reads) and AppleScript (writes).
Requirements: brew install ical-buddy
Commands
| Command | Description |
|---|---|
calctl calendars |
List all calendars |
calctl show [filter] |
Show events (today, tomorrow, week, YYYY-MM-DD) |
calctl add \x3Ctitle> |
Create a new event |
calctl search \x3Cquery> |
Search events by title (next 30 days) |
Examples
# List calendars
calctl calendars
# Show today's events
calctl show today
# Show this week's events
calctl show week
# Show events from specific calendar
calctl show week --calendar Work
# Show events on specific date
calctl show 2026-01-25
# Add an event
calctl add "Meeting with John" --date 2026-01-22 --time 14:00
# Add event to specific calendar
calctl add "Team Standup" --calendar Work --date 2026-01-22 --time 09:00 --end 09:30
# Add all-day event
calctl add "Holiday" --date 2026-01-25 --all-day
# Add event with notes
calctl add "Project Review" --date 2026-01-22 --time 15:00 --notes "Bring quarterly report"
# Search for events
calctl search "meeting"
Options for add
| Option | Description | Default |
|---|---|---|
-c, --calendar \x3Cname> |
Calendar to add event to | Privat |
-d, --date \x3CYYYY-MM-DD> |
Event date | today |
-t, --time \x3CHH:MM> |
Start time | 09:00 |
-e, --end \x3CHH:MM> |
End time | 1 hour after start |
-n, --notes \x3Ctext> |
Event notes | none |
--all-day |
Create all-day event | false |
Available Calendars
Common calendars on this system:
- Privat (personal)
- Work
- Familien Kalender
- rainbat solutions GmbH
- TimeTrack
Usage Guidance
This skill appears to be a macOS-only CLI wrapper for Apple Calendar (reads via icalBuddy, writes via AppleScript), but the registry metadata does not declare macOS as a required platform or the ical-buddy dependency. Before installing or enabling it:
- Confirm you are on macOS and are comfortable granting Terminal/osascript automation access to control Calendar (Apple will prompt for these permissions). Calendar write access lets the skill create/modify events — consider privacy implications.
- Manually install and vet ical-buddy (brew install ical-buddy) from a trusted source before using. The skill does not include an install script, so installation happens outside the skill.
- Ask the skill author (or the registry) to update metadata to list required binaries and restrict the skill to macOS, and to provide exact commands the agent will run (so you can review them).
- Prefer skills with a homepage or source repository so you can inspect the implementation. If you cannot verify the origin, avoid granting automation/Calendar permissions.
I rated this 'suspicious' because the documentation and metadata are inconsistent and sensitive permissions (Calendar access) are implied but not documented; this could be benign oversight, but verify the points above before use.
Capability Analysis
Type: OpenClaw Skill
Name: calctl
Version: 1.0.0
The skill bundle describes a tool for managing Apple Calendar events using `icalBuddy` and AppleScript. The `SKILL.md` content is purely descriptive, outlining the tool's functionality, commands, and installation requirements (`brew install ical-buddy`). There are no indicators of prompt injection, data exfiltration, malicious execution, persistence mechanisms, or obfuscation. The instructions are clearly aligned with the stated purpose and do not exhibit any high-risk behaviors.
Capability Assessment
Purpose & Capability
The SKILL.md clearly targets macOS (uses AppleScript/icalBuddy) and requires 'brew install ical-buddy', but the registry metadata lists no required binaries and no OS restriction. Asking to read and write a user's Calendar is coherent with the stated purpose, but the metadata omission is inconsistent and surprising.
Instruction Scope
The instructions focus on calendar operations (list/show/add/search) and mention using icalBuddy for reads and AppleScript for writes. They do not ask the agent to access unrelated files or external endpoints. However, the SKILL.md is purely descriptive (no concrete commands or implementation included) and contains example calendar names from a system — this may be benign sample data but is unexpected in a generic skill.
Install Mechanism
There is no install specification (lowest disk risk). Still, the documentation requires an external tool ('brew install ical-buddy'); that requirement is not reflected in metadata. Because installation is not automated by the skill, users will need to install ical-buddy and run on macOS themselves.
Credentials
The skill declares no environment variables or credentials (appropriate), but it will need access to the user's Calendar via AppleScript/osascript and likely Terminal automation permissions. Those sensitive access needs are not documented in the metadata (no platform/permission guidance), which is disproportionate to the registry's blank requirements.
Persistence & Privilege
The skill does not request always:true and uses default autonomous invocation settings. There is no evidence it requests persistent system-wide privileges or modifies other skills' configurations.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install calctl - After installation, invoke the skill by name or use
/calctl - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of calctl – Apple Calendar CLI.
- Manage Apple Calendar events from the command line.
- Fast reads using icalBuddy; event creation and editing with AppleScript.
- List calendars, show events (daily, weekly, or by date), add new events, and search upcoming events.
- Supports options for specifying calendar, date, time, all-day events, and notes.
- Easy integration with existing system calendars.
Metadata
Frequently Asked Questions
What is Calctl?
Manage Apple Calendar events via icalBuddy + AppleScript CLI. It is an AI Agent Skill for Claude Code / OpenClaw, with 2664 downloads so far.
How do I install Calctl?
Run "/install calctl" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Calctl free?
Yes, Calctl is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Calctl support?
Calctl is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Calctl?
It is built and maintained by rainbat (@rainbat); the current version is v1.0.0.
More Skills