Calendar Check

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.

meleantonio Updated

File contents

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.

meleantonio/cursorericbuild/tree/main/workstation/.cursor/skills/calendar-check commit 6da8490fe5

Frequently asked questions

npx skillmds@latest add meleantonio/calendar-check