gog

gog

A command-line client for Google Workspace services — Gmail, Calendar, Drive, Docs, Sheets, Contacts and more — built for personal, single-user automation.

What it is

gog is a self-hosted command-line tool that connects to Google APIs on behalf of its owner. It is not a hosted service, has no public sign-up, and is used exclusively by the person who installs and authorizes it on their own machine.

You authorize the tool once through Google's standard OAuth 2.0 consent flow. After that, it can read and act on the Google data you explicitly granted it access to. Nothing is accessed without your authorization, and access can be revoked at any time.

What it can do

GmailSearch, read, label, draft and send mail
Google CalendarList, create and update events
Google DriveSearch, list, upload and download files
Google DocsRead and export documents
Google SheetsRead, update and append cell ranges
Google SlidesWork with presentations
Google ContactsList and search contacts
Google TasksManage task lists and items
Google Chat & MeetMessaging and meeting artifacts
Google Forms & SitesForm and site information
Analytics & Search ConsoleRead performance reporting
Google AdsRead campaign reporting
YouTube & PhotosRead associated content
Google ClassroomCourse and roster information

Each capability is enabled only by the specific OAuth scopes you grant. A feature that is not authorized cannot be used.

Who uses it

gog is a personal-use application — it serves a single user: the person who installs it and authorizes it against their own Google Account. It has fewer than 100 users, is not distributed publicly, and has no multi-tenant or hosted component.

Because it runs locally on the owner's machine and is operated by the owner alone, there are no third-party users and no end-user accounts.

Your data stays yours. Google user data accessed by gog is never sold, never shared with third parties, never used for advertising or profiling, and never used to train machine-learning models.

See the Privacy Policy for exactly what is accessed and how it is handled.

Requirements

Getting started

Authorization uses Google's standard OAuth 2.0 flow. You grant access directly to Google, choose which services are permitted, and can revoke access at any time from myaccount.google.com/permissions.