event
cmdhub adapter

GCal CLI
for cmdhub.

Calendars, events, freebusy, and slots from the terminal.

lock Auth: OAuth2
Quick Install cmdhub get gcal

terminal Command Reference

Generated from source. Global flags apply to all commands.

Global Flags

--config string Config path override
--cursor string Continuation cursor
--debug bool Enable debug diagnostics
--json bool Alias for --output json
--jsonl bool Alias for --output jsonl
--limit int = 50 Maximum items to emit
--no-paginate bool Fetch only one page
--output, -o string = human Output mode: human|json|jsonl
--page-size int = 50 Requested upstream page size
--profile string = default Config/auth profile
--quiet, -q bool Suppress non-essential diagnostics
--trace-id string Trace identifier
--view string = summary View mode: summary|full

gcal auth — Manage Google Calendar authentication

gcal auth login Authenticate with Google Calendar
gcal auth logout Remove stored credentials
gcal auth refresh Refresh stored token
gcal auth status Show auth status
gcal auth whoami Show current calendar identity

gcal calendar — Manage calendars

gcal calendar get Get a calendar
gcal calendar list List calendars
gcal calendar search Search calendars by summary
--query string Search text
gcal capabilities Describe gcal capabilities
gcal doctor Run gcal diagnostics

gcal event — Manage calendar events

gcal event create Create an event
--all-day bool All-day event
--calendar string = primary Calendar selector
--description string Description
--duration string Duration
--end string Event end
--location string Location
--start string Event start
--title string Event title
gcal event delete Delete an event
--calendar string Optional calendar selector
gcal event get Get an event
--calendar string Optional calendar selector
gcal event list List events
--calendar string = primary Calendar selector
--from string Start time
--to string End time
--today bool Today window
--tomorrow bool Tomorrow window
--week bool Week window
gcal event quick-add Create an event from natural text
--calendar string = primary Calendar selector
--text string Quick-add text
gcal event search Search events
--calendar string = primary Calendar selector
--from string Start time
--query string Search query
--to string End time
gcal event update Update an event
--all-day bool All-day event
--calendar string Optional calendar selector
--description string Description
--duration string Duration
--end string Event end
--location string Location
--start string Event start
--title string Event title

gcal freebusy — Inspect busy windows

gcal freebusy get Get busy windows for calendars
--calendar stringSlice = [primary] Calendar selectors
--from string Start time
--to string End time
gcal resolve Resolve a marker or short id
gcal schema Emit gcal schema hints
--in bool Show input schema
--out bool Show output schema

gcal slot — Find open slots

gcal slot find Find open slots across calendars
--calendar stringSlice = [primary] Calendar selectors
--duration string = 30m Minimum slot duration
--from string Start time
--to string End time
gcal version Show gcal version information

play_circle Live Examples

Output captured from a real workspace. Regenerate with scripts/gen-docs.sh --update.

auth

Check current identity
$ gcal auth whoami
Authenticated  kestrelphilip@gmail.com

alt_route Composition Patterns

Bridge your ecosystem with zero middleware.

# Turn a transformed email into a calendar event
gmail message list --label INBOX --limit 1 --output jsonl \
  | agent adapt --to "gcal event create"