cal-cli

What This Skill Does

The cal-cli skill provides a powerful, direct bridge to the macOS Calendar (EventKit) via a high-performance Go-based CLI tool. It enables OpenClaw to perform full CRUD (Create, Read, Update, Delete) operations on both calendar events and calendar containers. By leveraging native macOS APIs, the skill ensures sub-millisecond read times, making it ideal for managing schedules, automating meeting logistics, or syncing complex calendar workflows without leaving the terminal environment.

Installation

To integrate this tool into your OpenClaw ecosystem, execute the following command in your terminal: clawhub install openclaw/skills/skills/bro3886/ical-cli

Alternatively, for manual control, you can install the Go binary directly via: go install github.com/BRO3886/ical/cmd/ical@latest

Use Cases

This skill is designed for power users who rely on the macOS ecosystem but need faster, automated control over their time. Use cal-cli to:

• Automate agenda reporting: Have the AI summarize your daily schedule or list upcoming week-long commitments.
• Streamline Meeting Creation: Use natural language to parse dates and times (e.g., "Schedule a sync tomorrow at 2 PM") and pipe them directly into the correct calendar.
• Workflow Automation: Export calendar data to CSV or JSON for external processing, or import bulk events via supported file formats.
• Calendar Hygiene: Quickly batch-delete outdated events or rename calendars across different sources like iCloud or local accounts.

Example Prompts

1. "What does my schedule look like for the rest of the week? Please list all events and include the location for each."
2. "Add a new meeting called 'Project Architecture Review' for next Tuesday at 10 AM, lasting one hour, and set a reminder for 15 minutes before."
3. "Find all meetings containing the word 'Design' in the next 30 days and export them to a file named design_events.csv."

Tips & Limitations

• Safety: When running automated scripts, always append the --force flag to delete commands to bypass interactive confirmation prompts, which may otherwise hang an automated agent process.
• Natural Language: The tool excels at understanding relative time expressions like 'today', 'tomorrow', or 'end of week'. Use these liberally for efficient scheduling.
• Scope: This skill interacts exclusively with the local macOS EventKit store. It requires appropriate system permissions to access your calendar data. Ensure your terminal or OpenClaw agent has the necessary 'Full Disk Access' or 'Calendar' permissions granted in System Settings for the operations to succeed.