gogcli - Google Workspace CLI

name: gogcli description: Google Workspace CLI for Gmail, Calendar, Drive, Sheets, Docs, Slides, Contacts, Tasks, People, Groups, Keep. Use when user asks to interact with Google services.

gogcli - Google Workspace CLI

Overview

gogcli is a CLI tool for managing Google Workspace services from the terminal. Supports Gmail, Calendar, Drive, Sheets, Docs, Slides, Contacts, Tasks, People, Groups, and Keep.

Installation

Quick Install (if you have brew):

brew install steipete/​tap/​gogcli

Build from Source (no brew):

# 1. Clone repository
git clone https://github.com/​steipete/​gogcli.git

# 2. Navigate to directory
cd gogcli

# 3. Build
make

# 4. (Optional) Make available globally
sudo make install

First Time Setup

Before using gogcli, set up OAuth credentials:

Step 1: Get OAuth Client Credentials

1. Go to Google Cloud Console APIs & Services
2. Create project or use existing one
3. Go to OAuth consent screen
4. Create OAuth 2.0 client with these settings:
   • Application type: "Desktop app"
   • Name: "gogcli for Clawdbot"
   • Authorized redirect URIs: http://localhost:8085/​callback
5. Enable APIs you need
6. Download OAuth client credentials JSON file
7. Copy to ~/​Downloads/

Step 2: Authorize Your Account

cd gogcli
./​bin/​gog auth add [email protected] ~/​Downloads/​client_secret_....json

Step 3: Verify

./​bin/​gog auth list
./​bin/​gog gmail search 'is:unread' --max 5

Common Commands

Gmail

# Search
./​bin/​gog gmail search 'query' --max 20

# Send
./​bin/​gog gmail send '[email protected]' --subject 'Hello' --body 'Message'

# Labels
./​bin/​gog gmail labels list

Calendar

# List events
./​bin/​gog calendar events list --max 50

# Create event
./​bin/​gog calendar events create 'Meeting' --start '2026-01-30T10:00'

Drive

# List files
./​bin/​gog drive ls --query 'pdf' --max 20

# Upload file
./​bin/​gog drive upload ~/​Documents/​file.pdf

Sheets

# List sheets
./​bin/​gog sheets list

# Export sheet
./​bin/​gog sheets export <spreadsheet-id> --format pdf

Contacts

./​bin/​gog contacts search 'John Doe'

Tasks

# List tasklists
./​bin/​gog tasks list

# Add task
./​bin/​gog tasks add --title 'Task' --due '2026-01-30'

Notes

• Use --json flag for scripting
• Credentials stored in ~/​.config/​gog/
• Use gog auth list to check authentication status