nanocal

name	nanocal
description	Read, create, update, and delete Apple Calendar events with the nanocal CLI. Use when working on a Mac where nanocal is installed and you need calendar access from the terminal.

nanocal CLI

Use nanocal directly. Always use --json for structured output.

Read

nanocal calendars --json
nanocal events --json --from "2026-02-14" --to "2026-02-15"
nanocal events --json -c "Work" --search "standup"
nanocal today --json
nanocal upcoming --json --days 14
nanocal show --id "EVENT-UUID" --json

Write

nanocal create -c "Work" --title "Standup" --start "2026-02-14T10:00:00" --end "2026-02-14T10:30:00" --json
nanocal update --id "EVENT-UUID" --title "Updated title" --json
nanocal delete --id "EVENT-UUID" --json

Workflow

1. Run calendars --json first for exact calendar names.
2. Pull IDs from events, today, or upcoming before show, update, or delete.
3. Use ISO 8601 date or datetime strings.
4. Ask for confirmation before create, update, or delete.

Options

Flag	Description
--json	Output JSON (always use this)
--search <query>	Filter by title, location, notes, or attendees
-c <calendar>	Filter by calendar name (case-insensitive)
--limit <n>	Max results to return
--offset <n>	Skip first N results