gog-cli - Google Workspace CLI

Command-line tool for interacting with Google Workspace services.

Service References

Load only the reference file for the service you need:

• Email operations - See references/gmail.md

• Calendar & scheduling - See references/calendar.md

• File storage - See references/drive.md

• Spreadsheets - See references/sheets.md

• Documents & presentations - See references/docs-slides.md

• Contact management - See references/contacts.md

• Task lists - See references/tasks.md

• Team messaging - See references/chat.md

• Education/courses - See references/classroom.md

Global Options

Apply to any command:

Option Description

--account <email|alias>

Specify account to use

--json

Machine-readable JSON output

--plain

Tab-separated plaintext

--force

Skip confirmation prompts

--no-input

Fail rather than prompt (CI-friendly)

--verbose

Show API requests/responses

Quick Examples

Gmail: search recent emails

gog gmail search 'newer_than:7d' --max 10

Calendar: today's events

gog calendar events primary --today

Drive: list files

gog drive ls --max 20

Sheets: read cells

gog sheets get <spreadsheetId> 'Sheet1!A1:B10'

Tasks: list task lists

gog tasks lists

Utility Commands

Current time

gog time now gog time now --timezone America/New_York

Auth status

gog auth list --check gog auth status

Tips

• Use --json for scripting and piping to jq

• Most IDs can be found in Google URLs (e.g., spreadsheet ID in sheets URL)

• Gmail search uses Google's search syntax (from:, to:, subject:, newer_than:, etc.)

• Calendar accepts "primary" as calendarId for main calendar