explaingit

openclaw/gogcli

★ 7,400GoAudience · developerComplexity · 3/5Setup · moderate

TLDR

A command-line tool that lets you interact with Gmail, Calendar, Drive, Docs, Sheets, and a dozen other Google Workspace services from a terminal or shell script, returning JSON or plain text output.

Mindmap

mindmap
  root((gogcli))
    Services
      Gmail
      Calendar
      Drive
      Docs and Sheets
      YouTube
    Output
      JSON mode
      Plain text mode
    Auth Options
      OAuth accounts
      Service accounts
      Multi-account
    Safety
      Block send ops
      Read-only audits
      Command allowlists
    Install
      Homebrew
      Docker
      Windows zip
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Write shell scripts that send Gmail messages, create calendar events, or upload Drive files automatically without a browser

USE CASE 2

Integrate Google Workspace operations into CI pipelines and coding agents

USE CASE 3

Use allowlists to safely lock down which Workspace commands a given automation script is permitted to run

Tech stack

GoDockerOAuth

Getting it running

Difficulty · moderate Time to first run · 1h+

Requires creating a Google Cloud project, enabling the relevant APIs, and setting up an OAuth client before first use.

In plain English

gogcli (invoked as gog) is a command-line tool that lets you interact with Google Workspace services from a terminal, a shell script, or an automated workflow. Instead of using a web browser to check Gmail, create calendar events, or browse Drive files, you type commands and get structured output back. The tool covers a wide range of Google services: Gmail, Calendar, Drive, Docs, Sheets, Slides, Forms, Meet, Apps Script, Analytics, Search Console, Contacts, Tasks, Classroom, Chat, YouTube, and Workspace admin flows. Each command can return output as JSON (for scripts and programs to parse) or plain text (for human reading), and error messages or progress updates go to a separate output channel so they do not interfere with scripted use. Setting it up requires creating a Google Cloud project, enabling the APIs for the services you want to use, and creating an OAuth client that gog can use to authenticate on your behalf. The tool supports multiple Google accounts at the same time, and for organizational Workspace environments it also supports service accounts and application default credentials. You can install it via Homebrew on Mac, Docker, a Windows zip download, or by building from source. The README includes safety features worth noting: you can configure the tool to block send operations during automation (so a script cannot accidentally send emails), and Drive audit commands are read-only by default. There are also allowlists and denylists for which commands a given binary is permitted to run, which is useful for locked-down automation environments. The project is written in Go and ships with generated reference documentation for every command. It is designed to work well as a building block in coding agents and CI pipelines.

Copy-paste prompts

Prompt 1
Show me how to set up gogcli to send a Gmail message from a shell script, including the Google Cloud OAuth setup steps.
Prompt 2
Write a bash script using gog that reads my Google Calendar for today and prints upcoming events as plain text.
Prompt 3
How do I configure gogcli to use a Google service account for automated Workspace admin tasks in a CI pipeline?
Prompt 4
Using gog, write a script that uploads a local file to Google Drive and prints the shareable link.
Prompt 5
How do I configure gogcli to block outgoing send operations so a script cannot accidentally email someone during testing?
Open on GitHub → Explain another repo

← openclaw on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.