macos-calendar_skill

Overview

This skill manages Apple Calendar events on macOS using AppleScript wrappers. It creates, lists, and updates events with robust date handling so commands like “remind me in 3 days” or “schedule a meeting next Monday” map reliably to calendar entries. It is macOS-only and designed to avoid locale issues by using relative dates or ISO dates.

How this skill works

The skill lists available calendars and sends validated JSON payloads to an AppleScript launcher that performs event creation, updates, or listing. Dates are specified with offset_days (relative to today) or iso_date (YYYY-MM-DD) to prevent locale parsing errors. Recurrence rules use standard iCal RRULE strings and alarms are specified in minutes before the event.

When to use it

• Add a one-off event like appointments, deadlines, or reminders.
• Schedule recurring meetings using iCal RRULE syntax.
• Create all-day events such as vacations or holidays.
• Set alerts by specifying alarm_minutes to get reminders.
• List calendars to choose the correct calendar before creating events.

Best practices

• Always run list-calendars first if the calendar is not specified to avoid choosing a read-only calendar.
• Prefer offset_days for relative times (e.g., tomorrow, in 3 days) or iso_date for absolute dates to avoid locale issues.
• Pass event data via stdin as JSON; do not supply sensitive fields on the command line.
• Confirm calendar name with the user when multiple personal calendars exist.
• Use validated RRULE strings for recurring events and consult recurrence references when needed.

Example use cases

• Remind me to call the dentist in 2 days: create a short appointment with offset_days=2 and alarm_minutes=30.
• Schedule a weekly team sync every Tuesday at 14:00: use recurrence FREQ=WEEKLY;BYDAY=TU and set duration_minutes.
• Block a vacation day as all-day on a specific date: iso_date=YYYY-MM-DD and all_day=true.
• Create a next-Thursday appointment by computing day offset and passing offset_days with hour and minute.
• Set up a weekday standup for 4 weeks using FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR;COUNT=20.