calendar-check

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.