Назад към всички

gogcli

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

$ git log --oneline --stat
stars:370
forks:70
updated:February 19, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
namegogcli
descriptionGoogle 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 you@gmail.com ~/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 'recipient@gmail.com' --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