# 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.

- Skill: `meleantonio/calendar-check` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add meleantonio/calendar-check`
- Raw SKILL.md: https://api.skillmd.com/api/skills/meleantonio/calendar-check/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: meleantonio (https://skillmd.com/u/meleantonio)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/meleantonio/calendar-check

---


# 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):

```bash
python3 workstation/.cursor/skills/calendar-check/scripts/calendar_events.py --today
```

Custom ISO range:

```bash
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.