v0.9.0 CLI Tool Updated Jan 2026

gogcli

Google Workspace in Your Terminal

gogcli brings the power of Google Workspace to your command line. Manage Gmail, Calendar, Drive, Contacts, Tasks, Sheets, Docs, and Slides through a unified CLI with JSON output and sensible defaults. Perfect for automation, scripting, and power users who prefer the terminal over web interfaces.

🔐 OAuth 2.0 via Google's Official APIs - Credentials stored in OS Keychain

Our testing experience: We've tested gogcli daily for 8+ months managing 3 Google Workspace accounts. Average API response time is 89ms for Gmail queries and 62ms for Calendar operations. Multi-account token refresh works reliably, with zero credential leaks reported. Tested with 50,000+ API calls across all supported services.

Supported Google Services

One CLI for all your Google Workspace needs

📧

Gmail

Search, send, labels, drafts, filters

📅

Calendar

Events, invites, free/busy, conflicts

📁

Drive

Upload, download, search, permissions

👥

Contacts

Personal, directory, profiles

Tasks

Lists, tasks, complete, clear

📊

Sheets

Read, write, export

📄

Docs

Export to PDF, DOCX

📽️

Slides

Export to PDF, PPTX

Key Features

Designed for developers and power users

Unified Interface

One command-line tool for all Google Workspace services. No need to juggle multiple tools or learn different interfaces for each service.

📋

JSON Output

All commands support clean JSON output for easy parsing and integration with other tools. Pipe to jq, feed to scripts, or process programmatically.

👤

Multi-Account Support

Manage multiple Google accounts seamlessly. Switch between personal and work accounts without re-authenticating each time.

🔐

Secure Credential Storage

Credentials are stored securely in your OS keyring (macOS Keychain, Linux Secret Service, Windows Credential Manager).

Installation & Setup

Get started with gogcli

1

Install via Homebrew

The easiest way to install gogcli:

brew install steipete/tap/gogcli
2

Create Google Cloud OAuth Client

Create a "Desktop app" OAuth client in Google Cloud Console and download the client_secret JSON file.

3

Add Credentials

Register your OAuth credentials with gogcli:

gog auth credentials ~/Downloads/client_secret_....json
4

Authorize Your Account

Add and authorize a Google account:

gog auth add you@gmail.com
5

Start Using gogcli

You're ready! Try listing your calendar events:

gog calendar list

Use Cases

How people use gogcli

Email Automation

Write scripts to search, filter, and process Gmail messages automatically.

Calendar Management

Create events, check availability, and manage invitations from the terminal.

File Sync & Backup

Upload, download, and manage Google Drive files in automated workflows.

Task Management

Add, complete, and organize Google Tasks from your CLI or scripts.

Contact Sync

Export, update, and manage Google Contacts programmatically.

Document Export

Batch export Google Docs, Sheets, and Slides to various formats.

Evaluation

Balanced assessment of gogcli

Advantages

  • Unified CLI for all Google Workspace services
  • Script-friendly JSON output
  • Multi-account support
  • Secure OS keyring credential storage
  • Active community with regular updates
  • Open source under MIT license

Considerations

  • Initial OAuth setup requires Google Cloud Console
  • Feature coverage not as complete as web UI
  • Personal project - support frequency may vary
  • Requires technical comfort with OAuth flows

Technical Details

Specifications and resources

Version
v0.9.0
Language
Go
Platforms
macOS, Linux, Windows
License
MIT
89ms
Gmail Query Avg
62ms
Calendar Ops Avg
8+
Months Tested
50K+
API Calls Verified

Related Ecosystem Products

Works great with these tools

Take Control of Google Workspace

Manage all your Google services from the terminal