apple-calendar-manager
v1.0.0Manage Apple Calendar events via AppleScript. Create, edit, delete, and search calendar events.
Installation
Apple Calendar Manager
This skill allows OpenClaw to manage events in Apple Calendar using AppleScript.
Capabilities
- Add new events to a specified calendar with smart date parsing (e.g., "today", "tomorrow", "next Monday").
- (Future) Edit existing events.
- (Future) Delete events.
- (Future) Search for events.
Requirements
- macOS
- Apple Calendar application must be accessible and authorized for automation.
- The calendar name must exist in the user's Calendar app.
Usage
Add an Event (Smart Date Parsing)
Use the add_event_smart.sh script to add events with relative dates or explicit dates.
Arguments:
1. calendar_name: The name of the calendar (e.g., "Рабочий", "Домашний").
2. event_summary: The title of the event.
3. event_description: (Optional) Description for the event.
4. relative_start_date: Relative date for start (e.g., "today", "tomorrow", "day after tomorrow", "понедельник", "next monday") or absolute date (e.g., "2026-02-23").
5. start_time: Start time (format HH:MM, e.g., "12:00").
6. relative_end_date: Relative date for end (same as relative_start_date).
7. end_time: End time (format HH:MM, e.g., "15:00").
Example:
skills/apple-calendar-manager/add_event_smart.sh "Рабочий" "Чай с Настей" "Чай с Настей с 12 до 15" "tomorrow" "12:00" "tomorrow" "15:00"
Add an Event (Absolute Date Parsing)
Use the add_event.scpt script directly if you prefer to provide absolute dates in YYYYMMDDHHMMSS format.
Arguments:
1. calendar_name: The name of the calendar.
2. event_summary: The title of the event.
3. event_description: Description for the event.
4. start_datetime_formatted: Start date and time in YYYYMMDDHHMMSS format.
5. end_datetime_formatted: End date and time in YYYYMMDDHHMMSS format.
Example:
osascript skills/apple-calendar-manager/add_event.scpt "Рабочий" "Тест скилла Календарь" "Тестовое событие" "20260225140000" "20260225150000"
Implementation Details
- Uses
osascriptfor direct Apple Calendar application control. parse_relative_date.shscript handles conversion of relative date strings to absolute date/time formats required by AppleScript.- Requires Apple Calendar.app to be running and accessible.
- macOS-only.