calendar-cli

name	calendar-cli
description	Manage calendar events and send meeting invitations. Use for listing, creating, editing, deleting events and sending/replying to invites.

Usage

• Always pass an Olson timezone (Europe/Berlin, America/New_York) when creating or editing events. Ask the user if unclear.
• Run calendar-cli calendars first to discover available calendar names. Calendar names are resolved case-insensitively.
• list, show, and search do not sync by default (fast, uses local cache). Pass --sync to pull remote changes first.
• new, edit, and delete always sync after the operation.
• list shows at most 50 events by default and truncates descriptions. Use show <uid> to get full details of a specific event.

calendar-cli calendars
calendar-cli list                                     # today + 7 days
calendar-cli list --from 2025-04-01 --to 2025-04-07 -v
calendar-cli list --days 30 --limit 100               # more events
calendar-cli search "dentist"                          # find by text
calendar-cli search "sprint|retro" -c work -v          # regex, one calendar
calendar-cli show <uid>                                # full details

calendar-cli new "Meeting" --start "2025-04-01 14:00" --timezone Europe/Berlin -d 60 -c personal
calendar-cli new "Standup" --start "2025-04-01 09:00" --timezone America/New_York \
  -d 15 --rrule "FREQ=WEEKLY;BYDAY=MO,WE,FR" --alarm 15m

calendar-cli edit <uid> --summary "New Title"
calendar-cli edit <uid> --start "2025-04-02 10:00" --timezone Europe/Berlin
calendar-cli delete <uid>

For email invites, import and RSVP see EMAIL_INVITES.md.