macos-calendar-assistant

name

macos-calendar-assistant

description

Manage macOS Calendar with OpenClaw in IM-first workflows (Telegram/Discord/Feishu/iMessage/Slack), including screenshot-to-schedule extraction, idempotent create/update, move/extend/reschedule, reminders, conflict checks, daily review sync, and duplicate cleanup. Use when users ask to add/edit/move/postpone events, parse schedule screenshots/chat messages, adjust weekly plans into daily execution, or keep calendar and review notes in sync.

macos-calendar-assistant

Use bundled scripts for reliable Calendar.app operations.

Workflow

1. Extract title, start/end, timezone, calendar, location, notes, alarm.
2. Check conflicts before writing:
   • scripts/list_events.swift <start_iso> <end_iso>
3. Prefer idempotent writes:
   • scripts/upsert_event.py (create/update/skip)
4. Apply alarm if requested:
   • scripts/set_alarm.py --uid <event_uid> --alarm-minutes <n>
5. For hygiene, run duplicate scan:
   • scripts/calendar_clean.py --start <iso> --end <iso>

Calendar routing defaults

• Workout / Run / Training → Training
• Work / Meeting / Client → Work
• Product / Development / Building → Product
• Personal / Social / Travel → Life
• If unspecified: prefer writable iCloud/CalDAV calendars over local calendars.

Note: Calendar names vary by user setup. Map the intent to the closest local calendar name before writing.

Commands

List calendars

swift scripts/list_calendars.swift

List events in range