whatisgithub

What is gogcli?

openclaw/gogcli — explained in plain English

Analysis updated 2026-06-24

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

In one sentence

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

What do people build with it?

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

What is it built with?

GoDockerOAuth

How does it compare?

openclaw/gogclimightymoud/sidekickcjbassi/gotop
Stars7,4007,3977,410
LanguageGoGoGo
Setup difficultymoderatemoderateeasy
Complexity3/53/51/5
Audiencedeveloperdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get 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.

So what is it?

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?

Frequently asked questions

What is gogcli?

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.

What language is gogcli written in?

Mainly Go. The stack also includes Go, Docker, OAuth.

How hard is gogcli to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is gogcli for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.