A specialized skill for managing Apple Calendar events and schedules on macOS using natural language commands and programmatic AppleScript execution.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install macos-calendar
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 macos-calendar 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 macOS Calendar Management?
This skill provides a robust interface for AI agents to interact with the native macOS Calendar application. By leveraging Openclaw Skills, users can automate the creation, listing, and management of calendar entries without manual data entry. It solves the complexity of date formatting by using relative math and localized calculations, ensuring that scheduling requests like "next Monday" or "in 3 days" are accurately translated into system-level events.
Built for the macOS ecosystem, it utilizes a combination of Bash, AppleScript, and Python to bridge the gap between high-level agent logic and low-level system automation. Whether you are managing work meetings or personal reminders, this skill ensures that your agent can maintain your schedule with precision and reliability.
macOS Calendar Management Use Cases
- Scheduling one-off meetings and doctor appointments using natural language.
- Setting up recurring daily standups or weekly 1-on-1 sessions using iCal RRULE strings.
- Blocking out entire days for vacations or holidays using all-day event flags.
- Adding time-sensitive reminders with custom alarm offsets to ensure you never miss a deadline.
- Querying available calendars to organize events across different categories like Work, Personal, or Family.
How macOS Calendar Management Works
- The agent receives a scheduling request and first lists available calendars to identify writable targets.
- User input is mapped to a structured JSON object, calculating date offsets from the current system time.
- The JSON payload is passed via standard input to a specialized shell script to maintain data privacy.
- A Python helper parses the JSON and prepares an AppleScript (osascript) command.
- The system executes the AppleScript to interact directly with Calendar.app, creating or updating the requested event.
- The action is validated and recorded in a local log file for auditability.
macOS Calendar Management Setup
This skill requires macOS and the native Calendar.app. Ensure you have the necessary binary dependencies installed.
# Check for required tools
which osascript
which python3
# Initialize by listing your existing calendars
"$SKILL_DIR/scripts/calendar.sh" list-calendars
macOS Calendar Management Data Schema & Taxonomy
The skill processes data through a specific JSON schema to ensure accuracy across different locales. Below are the primary fields used:
| Field | Type | Description |
|---|---|---|
summary |
String | The title of the event |
calendar |
String | The target calendar name |
offset_days |
Integer | Relative days from today (e.g., 1 for tomorrow) |
iso_date |
String | Absolute date in YYYY-MM-DD format |
hour / minute |
Integer | Start time in 24-hour format |
duration_minutes |
Integer | How long the event lasts |
alarm_minutes |
Integer | Minutes before start for the notification trigger |
recurrence |
String | iCal RRULE string for repeating patterns |
macOS Calendar Management Advanced Features
- Smart date calculation logic that bypasses locale-specific date string errors by using relative math.
- Full support for iCal RRULE syntax, enabling complex recurrence patterns like bi-weekly or specific weekday repetitions.
- Read-only protection that automatically identifies and prevents attempts to write to locked or subscription-based calendars.
- Secure processing pipeline that passes sensitive event details via stdin to prevent data exposure in process lists.
- Automated logging system that tracks every event creation with timestamps and summary details in a dedicated log file.
SKILL.md
Loading
Related Openclaw Skills
Snapmaker Printer Control
Control and monitor your Snapmaker U1 3D printer through AI-driven automation using the Moonraker API.
Apple TV Control
A comprehensive automation skill that enables AI agents to control Apple TV hardware via the pyatv library for media playback and app management.
Video Generator MCP
An automated video production skill that converts product titles, descriptions, and images into marketing short videos via MCP tools.
0protocol
A cryptographic identity substrate that enables autonomous agents to sign plugins, rotate credentials, and make verifiable public attestations.
macOS Notes
A bridge for AI agents to create, read, and search Apple Notes using AppleScript and Python-based automation.
macOS Reminders
A specialized automation skill for managing macOS Reminders through natural language processing and AppleScript.
Featured*
