gog CLI

gog CLI is a powerful command-line tool that unifies all major Google Workspace services under a single binary. It provides seamless access to Gmail, Calendar, Drive, Contacts, Tasks, Sheets, Docs, Slides, and People APIs with JSON output support and sensible defaults for scripting and automation workflows.

• Multi-Service Integration - Access Gmail, Calendar, Drive, Contacts, Tasks, Sheets, Docs, Slides, and People from one unified CLI tool without switching between different utilities or APIs.

• JSON Output Support - Use the --json flag for machine-readable output that pipes directly to tools like jq, making it ideal for scripting and automation workflows.

• Multi-Account Management - Manage multiple Google accounts with gog auth manage or set a default account via GOG_ACCOUNT environment variable to avoid repeating account flags.

• Secure Credential Storage - Stores OAuth tokens securely in your OS keyring (macOS Keychain, Linux Secret Service, or Windows Credential Manager) for safe credential management.

• Gmail Features - Search threads, send mail, manage labels, drafts, filters, settings, and set up Pub/Sub push notifications with the watch command.

• Calendar Operations - List, create, and update events, respond to invites, detect scheduling conflicts, and check free/busy availability.

• Drive Management - List, search, upload, and download files, export Google Docs formats, manage permissions and folders, and handle URLs.

• Document Export - Export Sheets, Docs, and Slides to various formats including PDF, DOCX, PPTX, XLSX, and CSV via the Drive API.

• Tasks Management - Full tasklist and task management with add, update, done, undo, delete, and clear operations with paging support.

To get started, install via Homebrew with brew install steipete/tap/gogcli or build from source. Store your Google Cloud OAuth client JSON with gog auth credentials, authorize your account with gog auth add, and start running commands with optional JSON output for scripting.