Google Calendar

Use gog for Google Calendar operations. Read ../gog/SKILL.md first for shared auth, output, safety, and live-write rules.

Safe start

gog auth list --check --json --no-input
gog schema calendar --json
gog --readonly --account user@example.com calendar events --today --json --wrap-untrusted

• Select the account explicitly with --account.
• Use --json --wrap-untrusted for agent-readable Google content.
• Use --readonly when the task must not mutate Google data.
• Use --no-input in automation and --dry-run before supported writes.
• Confirm the exact account, object, and mutation before any write or delete.

Commands

Command	Purpose
acl	List calendar ACL
alias	Manage calendar aliases
calendars	List calendars
changed	List most recently changed events (including deletions)
colors	Show calendar colors
conflicts	Find busy-time overlaps across calendars
create	Create an event
create-calendar	Create a new secondary calendar
delete	Delete an event
delete-calendar	Delete an owned secondary calendar
event	Get event
events	List events from a calendar or all calendars
focus-time	Create a Focus Time block
freebusy	Get free/busy
move	Move an event to another calendar
out-of-office	Create an Out of Office event
propose-time	Generate URL to propose a new meeting time (browser-only feature)
raw	Dump raw Google Calendar API response as JSON (Events.Get; lossless; for scripting and LLM consumption)
respond	Respond to an event invitation
search	Search events
subscribe	Add a calendar to your calendar list
team	Show events for Workspace group members (service account, direct token, or ADC)
time	Show server time
unsubscribe	Remove a calendar from your calendar list
update	Update an event
users	List workspace users (use their email as calendar ID)
working-location	Set working location (home/office/custom)

Run gog calendar <command> --help for flags and gog schema calendar <command> --json for the machine-readable contract. Do not guess command syntax.