| name | calendar-check |
| description | Lists events from macOS Calendar.app within a time range using AppleScript. Use when checking availability, summarizing the day, or before scheduling messages or tasks on a self-hosted macOS agent. |
Calendar check
When to use
- "Am I free tonight?" / "What's on my calendar today?"
- Cross-check times before suggesting dinner or meetings.
Prerequisites
- Calendar.app accessible; agent process may need Automation permission to control Calendar (System Settings → Privacy & Security).
Script (from workstation/ root)
Today (local midnight to midnight next day):
python3 workstation/.cursor/skills/calendar-check/scripts/calendar_events.py --today
Custom ISO range:
python3 workstation/.cursor/skills/calendar-check/scripts/calendar_events.py \
--start "2026-04-02T09:00:00" \
--end "2026-04-02T23:59:00"
Output is JSON: { "ok", "events": [ { "title", "start", "end", "location" } ], "range" }.
Notes
- Event times are returned as Calendar displays them (localized strings from AppleScript).
- Iterates all calendars the user has in Calendar.app.
