📝

Gog

Name: Gog
Author: Peter Steinberger

CLI tool to interact with Gmail, Calendar, Drive, Contacts, Sheets, and Docs from your AI agent via Google Workspace APIs.

Peter Steinbergerv1.0.0

ProductivityAutomationAPICLIDeveloper Tool

Connecting to VM...

npx clawhub@latest install gog

894Stars

175.5kDownloads

70Current Installs

3.6kAll-time Installs

v1.0.0Version

Requirements

gogDefault Google Account(optional)

Platforms

macoslinux

View Source(ClawHub)

Gog Skill Overview

gog is a command-line interface for Google Workspace that lets AI agents read, search, send, and manage Gmail, Google Calendar, Drive, Contacts, Sheets, and Docs. After a one-time OAuth setup, agents can run structured commands against all major Google Workspace services without writing custom API integration code. It is designed for scripting and automation, with --json and --no-input flags that make it easy to pipe output into other tools.

How to Use It

Step 1: Run in your terminal or install this skill on MyClaw

npx clawhub@latest install gog

Click the Install button at the top of this page for one-click setup

When to Use Gog

Best Fit

You want an AI agent to search, read, or send Gmail messages on your behalf.
You need to query or create Google Calendar events programmatically.
You want to read from or write data to Google Sheets as part of an automated workflow.
You need to export or inspect Google Docs content without building a custom OAuth integration.

When Not to Use

You need in-place editing of Google Docs content — gog supports export and read but not direct Docs edits (a full Docs API client is required for that).
You need to work with Google Workspace services beyond Gmail, Calendar, Drive, Contacts, Sheets, and Docs.

Key Features

Gmail Search & Send

Search your inbox using Gmail query syntax (e.g. newer_than:7d) and send emails directly from the CLI. Agents should confirm before dispatching mail.

Google Calendar Access

List and query calendar events by calendar ID and ISO date range, making it easy to build scheduling assistants or read upcoming meetings.

Google Sheets Read, Write & Append

Get, update, append, clear, and inspect metadata for any Google Sheet using cell range notation. Values are passed as JSON arrays, and output can be returned as --json for downstream processing.

Google Drive Search

Search Drive files using flexible query strings and retrieve results in structured JSON format.

Google Docs Export

Export Docs to plain text or other formats, or stream content directly to stdout with gog docs cat, without needing a separate API client.

Multi-account & Scripting-friendly Design

Set GOG_ACCOUNT to avoid repeating --account on every command. Use --json and --no-input flags for clean, scriptable, non-interactive output suitable for agent pipelines.

Use Cases

AI email triage assistant

An agent searches Gmail for recent unread messages, summarizes them, and drafts or sends replies — all via gog gmail search and gog gmail send.

Automated calendar briefing

An agent fetches today's or this week's calendar events using gog calendar events and composes a daily schedule summary for the user.

Spreadsheet data pipeline

An agent reads rows from a Google Sheet, processes or enriches the data, then writes results back using gog sheets update or gog sheets append — without any manual copy-paste.

Document content extraction

An agent exports a Google Doc to plain text with gog docs cat or gog docs export to feed its contents into a summarization or analysis workflow.

Requirements

Google OAuth Credentials (required) — A client_secret.json file from Google Cloud Console is needed to run gog auth credentials and authorize access to Workspace services. Each Google account must be added via gog auth add with the desired services (gmail, calendar, drive, contacts, sheets, docs).

Connecting to VM...

npx clawhub@latest install gog

894Stars

175.5kDownloads

70Current Installs

3.6kAll-time Installs

v1.0.0Version

Requirements

gogDefault Google Account(optional)

Platforms

macoslinux

View Source(ClawHub)

FAQ

Reviews

0 reviews

No reviews yet. Be the first to share your experience!

Gog Skill Overview

When to Use Gog

Best Fit

You want an AI agent to search, read, or send Gmail messages on your behalf.
You need to query or create Google Calendar events programmatically.
You want to read from or write data to Google Sheets as part of an automated workflow.
You need to export or inspect Google Docs content without building a custom OAuth integration.

When Not to Use

You need in-place editing of Google Docs content — gog supports export and read but not direct Docs edits (a full Docs API client is required for that).
You need to work with Google Workspace services beyond Gmail, Calendar, Drive, Contacts, Sheets, and Docs.

Key Features

Gmail Search & Send

Search your inbox using Gmail query syntax (e.g. newer_than:7d) and send emails directly from the CLI. Agents should confirm before dispatching mail.

Google Calendar Access

List and query calendar events by calendar ID and ISO date range, making it easy to build scheduling assistants or read upcoming meetings.

Google Sheets Read, Write & Append

Get, update, append, clear, and inspect metadata for any Google Sheet using cell range notation. Values are passed as JSON arrays, and output can be returned as --json for downstream processing.

Google Drive Search

Search Drive files using flexible query strings and retrieve results in structured JSON format.

Google Docs Export

Export Docs to plain text or other formats, or stream content directly to stdout with gog docs cat, without needing a separate API client.

Multi-account & Scripting-friendly Design

Set GOG_ACCOUNT to avoid repeating --account on every command. Use --json and --no-input flags for clean, scriptable, non-interactive output suitable for agent pipelines.

Use Cases

AI email triage assistant

An agent searches Gmail for recent unread messages, summarizes them, and drafts or sends replies — all via gog gmail search and gog gmail send.

Automated calendar briefing

An agent fetches today's or this week's calendar events using gog calendar events and composes a daily schedule summary for the user.

Spreadsheet data pipeline

An agent reads rows from a Google Sheet, processes or enriches the data, then writes results back using gog sheets update or gog sheets append — without any manual copy-paste.

Document content extraction

An agent exports a Google Doc to plain text with gog docs cat or gog docs export to feed its contents into a summarization or analysis workflow.

Requirements

Google OAuth Credentials (required) — A client_secret.json file from Google Cloud Console is needed to run gog auth credentials and authorize access to Workspace services. Each Google account must be added via gog auth add with the desired services (gmail, calendar, drive, contacts, sheets, docs).