Gogcli is a command-line interface written in Go that brings Google Workspace services into the terminal. The project provides a single binary called gog that unifies access to Gmail, Calendar, Drive, Docs, Sheets, Slides, Forms, Meet, Apps Script, Analytics, Search Console, Contacts, Tasks, Classroom, Chat, YouTube, and Workspace administration tools. Rather than exposing raw API methods, gogcli organizes functionality around real-world tasks and workflows that often span multiple Google services.
The core design philosophy emphasizes task-first workflows, automation that composes reliably, and safety boundaries suitable for use by scripts, CI systems, and AI coding agents. The tool provides stable JSON and plain-text output formats, with prompts and warnings directed to stderr to preserve output predictability. It supports multiple authentication methods including account aliases, named OAuth clients, direct access tokens, Application Default Credentials, OS and encrypted-file keyrings, and Workspace service accounts. For agent safety, gogcli includes runtime read-only modes, command allow and deny rules, Gmail send restrictions, untrusted-content wrapping, dry-run planning capabilities, and a typed Model Context Protocol server that defaults to read-only access.
Installation is available through multiple channels including Homebrew, Docker, Windows ZIP downloads, and source builds. The project maintains comprehensive documentation covering installation, quickstart guides, authentication setup, command reference pages, automation patterns, and agent skill integration. The homepage at gogcli.sh provides rendered documentation for all features and workflows.
The tool handles Gmail operations including search, sanitization, and permanent deletion workflows. Calendar functionality covers appointment management, name resolution, and integration with services like Zoom. Drive operations include sharing audits, change tracking, revision history, and activity logs. Additional capabilities span Google Maps distance calculations and place searches, Google Photos library access through the Photos Picker API, contact deduplication and JSON-based updates, and comprehensive Docs editing with atomic request batching. Sheets support includes batch updates, table operations, and formatting controls. Slides can be generated from Markdown with template replacement and text editing features. Forms and YouTube functionality provide full API access for content management and analytics.
The project emphasizes that gog is open source and not affiliated with Google. It requires users to create their own Google Cloud projects and OAuth clients, with detailed setup instructions provided for enabling necessary APIs and managing OAuth consent screens. The tool handles the seven-day OAuth token expiry issue by recommending users publish their personal apps to production status before final authorization.
