Google

Google Workspace Skill

This skill provides Google Workspace integration using the gog CLI (gogcli). The agent calls gog directly for all operations.

Prerequisites

Install the gog binary:

# Homebrew
brew install openclaw/tap/gogcli

# Manual (Linux amd64)
curl -sL https://github.com/openclaw/gogcli/releases/latest/download/gogcli_VERSION_linux_amd64.tar.gz | tar xz
mv gog ~/.local/bin/

See [configuration.md](references/configuration.md) for container and MCP server alternatives.

Authentication

# Import credentials.json from Google Cloud Console
gog auth credentials set /path/to/credentials.json

# Authorize with only the services you need (opens browser)
gog auth add your@email.com --services gmail,calendar,drive,docs,sheets,slides

# Verify
gog auth doctor

Migrating from legacy Python OAuth

If you previously used the Python-based Google skills, clean up the old tokens and config:

$SKILL_DIR/scripts/google.py cleanup

Then set up fresh authentication with gog as described above.

Quick Reference

gog gmail search "is:unread"                    # Search email
gog calendar events --today                     # Today's events
gog drive search "quarterly report"             # Search files
gog docs cat                             # Read a document
gog sheets get  "Sheet1!A1:D10"  # Read spreadsheet range
gog slides info                 # Presentation metadata

All commands support --json for structured output and --plain for TSV.

Commands

Check Setup

$SKILL_DIR/scripts/google.py check

Gmail

# Search
gog gmail search "from:boss@example.com newer_than:7d"
gog gmail search "is:unread label:inbox" --max 20

# Read
gog gmail get 
gog gmail thread get 
gog gmail labels list

# Organize
gog gmail mark-read 
gog gmail unread 
gog gmail archive 
gog gmail trash 

# Send
gog gmail send --to "user@example.com" --subject "Hello" --body "Message body"
gog gmail reply  --body "Reply text"
gog gmail forward  --to "other@example.com"

# Drafts
gog gmail drafts list
gog gmail drafts create --to "user@example.com" --subject "Draft" --body "Content"
gog gmail drafts send 

See [gmail.md](references/gmail.md) for the full command reference.

Google Calendar

# View
gog calendar calendars
gog calendar events --today
gog calendar events --from "2026-06-25" --to "2026-06-30"
gog calendar event  
gog calendar freebusy --from "2026-06-25T09:00:00Z" --to "2026-06-25T17:00:00Z"
gog calendar search "standup"

# Create
gog calendar create primary --summary "Meeting" --from "2026-06-25T10:00:00" --to "2026-06-25T11:00:00"

# Manage
gog calendar update   --summary "Updated title"
gog calendar delete  
gog calendar respond   --status accepted

See [calendar.md](references/calendar.md) for the full command reference.

Google Drive

# Browse
gog drive ls
gog drive ls --folder 
gog drive search "quarterly report"
gog drive tree
gog drive get 

# File operations
gog drive upload report.pdf --parent 
gog drive download 
gog drive copy  "Copy of Report"
gog drive move  --parent 
gog drive rename  "New Name"
gog drive delete 

# Sharing
gog drive share  --email "user@example.com" --role writer
gog drive permissions 
gog drive unshare  

See [drive.md](references/drive.md) for the full command reference.

Google Docs

# Read
gog docs info 
gog docs cat 
gog docs export  --format md
gog docs structure 

# Write
gog docs create "New Document"
gog docs write  --body "Content to append"
gog docs insert  "Text to insert" --at 1
gog docs find-replace  "old text" "new text"
gog docs format  --bold --start 1 --end 10

# Tables
gog docs insert-table  --rows 3 --cols 4
gog docs cell-update  --row 1 --col 1 --body "Header"

See [docs.md](references/docs.md) for the full command reference.

Docs Workflows

For importing markdown with formatting, table styling, and round-trip editing, see [docs-workflows.md](references/docs-workflows.md).

# Import markdown as a new document with standard formatting
gog docs create "Document Title" --file document.md --pageless
gog docs format  --line-spacing 115 --space-below 8

# Update an existing document from markdown with formatting
gog docs write  --file document.md --markdown --replace --pageless
gog docs format  --line-spacing 115 --space-below 8

Google Sheets

# Read
gog sheets metadata 
gog sheets get  "Sheet1!A1:D10"
gog sheets get  "Sheet1!A:A" --format FORMULA

# Write
gog sheets create "New Spreadsheet"
gog sheets update  "Sheet1!A1" "value1" "value2" "value3"
gog sheets append  "Sheet1!A:D" "val1" "val2" "val3" "val4"
gog sheets clear  "Sheet1!A1:D10"

# Structure
gog sheets add-tab  "New Tab"
gog sheets delete-tab  "Old Tab"
gog sheets rename-tab  "Old Name" "New Name"

See [sheets.md](references/sheets.md) for the full command reference.

Google Slides

# Read
gog slides info 
gog slides list-slides 
gog slides read-slide  
gog slides export  --format pptx

# Create
gog slides create "New Presentation"
gog slides create-from-markdown "Deck Title" --file slides.md
gog slides create-from-template  "From Template" --replacements '{"{{NAME}}":"Value"}'

# Edit
gog slides new-slide 
gog slides insert-text   "Text content"
gog slides replace-text  "find" "replace"
gog slides insert-image   image.png --width 300

See [slides.md](references/slides.md) for the full command reference.

Examples

Search and summarize recent emails

gog gmail search "is:unread newer_than:7d" --json --results-only | jq '.[] | "\(.from): \(.subject)"'

Create a calendar event for tomorrow

TOMORROW=$(date -d '+1 day' '+%Y-%m-%dT09:00:00')
gog calendar create primary --summary "Team Standup" --from "$TOMORROW" --to "${TOMORROW%T*}T09:30:00"

Download recent documents

gog drive search "type:document newer_than:7d" --json --results-only | jq -r '.[] | .id' | \
  while read docId; do gog docs export "$docId" --format md > "doc_$docId.md"; done

Check availability for a meeting

gog calendar freebusy --from "2026-06-25T09:00:00Z" --to "2026-06-25T17:00:00Z"

Output Formatting

# JSON output (structured, for scripting)
gog gmail search "is:unread" --json --results-only

# Plain/TSV output (stable, parseable)
gog drive ls --plain

# Select specific fields
gog gmail search "is:unread" --json --select "id,subject,from"

Agent Safety

# Read-only mode (blocks all mutations)
gog --readonly gmail search "test"

# Block Gmail send specifically
gog --gmail-no-send gmail search "test"

# Preview actions without executing
gog --dry-run drive delete 

# Disable interactive prompts (fail instead)
gog --no-input calendar create primary --summary "Test"

Error Handling

| Exit Code | Meaning | Retryable | |-----------|---------|-----------| | 0 | Success | - | | 3 | Empty results | No (normal) | | 4 | Auth required | No (run gog auth setup) | | 5 | Not found | No | | 6 | Permission denied | No | | 7 | Rate limited | Yes (wait and retry) | | 8 | Retryable server error | Yes (wait and retry) |

Authentication and permission errors require user intervention. Rate limiting and server errors can be retried after a brief wait.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: odyssey4me
• Source: odyssey4me/agent-skills
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.