gog

Manages Gmail, Calendar, Drive, Contacts, Sheets, and Docs via the gog command-line interface.

Updated Mar 4, 2026
One-click install
npx skills add https://github.com/chisuhua/home --skill gog-chisuhua
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gog
Source: https://github.com/chisuhua/home/tree/main/.agents/skills.disabled/gog
Command: npx skills add https://github.com/chisuhua/home --skill gog-chisuhua

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Google Workspace services like Gmail, Calendar, Drive, and Sheets typically requires switching between web interfaces or writing custom API integrations. This Skill provides a unified command-line workflow for reading, sending, and organizing Google Workspace data directly from an AI agent session. ## Core Features & Use Cases - Gmail Operations: Search threads or individual messages, send plain-text or HTML emails, create and send drafts, and reply to existing messages. - Calendar Management: List, create, and update events with support for event colors and date-range queries. - Sheets and Docs Access: Read, update, append, and clear spreadsheet ranges, plus export or print Google Docs content. - Use Case: Ask the agent to find all emails from a specific sender in the last week, draft a follow-up reply, and log the contact details into a Google Sheet, all without leaving the conversation. ## Quick Start Ask the agent to search your Gmail for messages from the last 7 days and summarize the results.

Frequently Asked Questions about gog

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send an email from the command line with Gmail?▼

Use gog gmail send with --to, --subject, and --body flags for plain text. For multi-line messages, pass content via --body-file or stdin, and use --body-html when rich formatting with HTML tags is needed.

How do I search Gmail messages instead of threads?▼

Use gog gmail messages search with a query like "in:inbox from:example.com" to return one row per individual email. The standard gog gmail search groups results by thread, which can hide individual messages.

What setup is required before using gog with Google Workspace?▼

Install the gog binary via Homebrew, then run gog auth credentials with your client_secret.json file and gog auth add with your account and desired services. Verify the setup with gog auth list.

Can gog edit Google Docs content directly?▼

No, gog only supports exporting, printing, and copying Docs via docs export, docs cat, and copy commands. In-place editing of Google Docs requires a separate Docs API client, which gog does not provide.

How do I update a Google Sheets range from the command line?▼

Use gog sheets update with the sheet ID, a range like "Tab!A1:B2", and --values-json containing a JSON array of rows. Add --input USER_ENTERED so values are parsed as if typed by a user.