Agent skill
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.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/gogcli
SKILL.md
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
- Go to Google Cloud Console APIs & Services
- Create project or use existing one
- Go to OAuth consent screen
- Create OAuth 2.0 client with these settings:
- Application type: "Desktop app"
- Name: "gogcli for Clawdbot"
- Authorized redirect URIs:
http://localhost:8085/callback
- Enable APIs you need
- Download OAuth client credentials JSON file
- 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
--jsonflag for scripting - Credentials stored in
~/.config/gog/ - Use
gog auth listto check authentication status
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?