managing-calendar

name	managing-calendar
description	Use for any calendar work - scheduling meetings, finding free time, searching for events, auditing 1:1s, checking availability, or managing recurring meetings.
allowed-tools	Bash(gog:*)

Calendar Management

Manages Google Calendar via the gog CLI.

Discovery

Run gog calendar --help and gog calendar <subcommand> --help to discover available commands and flags. The CLI is well-documented.

Key Commands

# List events (today)
gog calendar events --today --json

# List events in a date range
gog calendar events --from 2026-03-01 --to 2026-03-07 --json

# Search events
gog calendar search "standup" --json

# Single event details
gog calendar event <calendarId> <eventId> --json

# Free/busy check
gog calendar freebusy <calendarIds> --from 2026-03-01 --to 2026-03-07 --json

# Find conflicts
gog calendar conflicts --from 2026-03-01 --to 2026-03-07 --json

# Create an event
gog calendar create <calendarId> --title "1:1 with Alice" --start "2026-03-05T10:00:00" --end "2026-03-05T10:30:00"

# Update an event
gog calendar update <calendarId> <eventId> --title "New Title"

# Delete an event
gog calendar delete <calendarId> <eventId>

Best Practices

• Query max 1 week at a time to avoid truncation
• Event IDs with _YYYYMMDD... suffix = recurring series instance
• Event IDs without suffix = one-off meeting
• Always check availability before scheduling
• Use --json for machine-readable output
• Default to silent updates — only send notifications when explicitly requested