OpenParable
Skip to content
← Back to skills

Gogcli

Apps & Automation
gogcli

Gogcli is an Agent Skill for apps & automation published in the CraftOS-dev/CraftBot repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/CraftOS-dev/CraftBot/blob/HEAD/skills/gogcli/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/gogcli, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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