How do I install the Gog skill?

Run npx skillmds@latest add shaggyd/gog in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Gog skill do?

Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs It is listed under Productivity on SkillMD.

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gog?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

ShaggyD (@shaggyd) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gog by shaggyd — Agent Skill

Name: Gog
Rating: 4.2 (5 reviews)
Author: ShaggyD

File contents

What I do

Control Gmail, Calendar, Drive, Contacts, Sheets, and Docs from the command line using gog.

Installation

brew install steipete/tap/gogcli

Setup (one-time)

# Authenticate with OAuth
gog auth credentials /path/to/client_secret.json

# Add account with services
gog auth add you@gmail.com --services gmail,calendar,drive,contacts,sheets,docs

# List accounts
gog auth list

Environment

# Set default account to avoid --account flag
export GOG_ACCOUNT=you@gmail.com

Gmail

Search emails

gog gmail search 'newer_than:7d' --max 10
gog gmail search 'from:boss@company.com is:unread' --max 20

Send email

gog gmail send --to a@b.com --subject "Hi" --body "Hello"

Calendar

List events

gog calendar events <calendarId> --from 2024-01-01 --to 2024-01-31

Drive

Search files

gog drive search "query" --max 10
gog drive search "name contains 'report' and modifiedTime > '2024-01-01'"

Contacts

gog contacts list --max 20

Sheets

Get values

gog sheets get <sheetId> "Tab!A1:D10" --json

Update values

gog sheets update <sheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED

Append rows

gog sheets append <sheetId> "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS

Clear cells

gog sheets clear <sheetId> "Tab!A2:Z"

Get metadata

gog sheets metadata <sheetId> --json

Docs

Export

gog docs export <docId> --format txt --out /tmp/doc.txt

Cat (print contents)

gog docs cat <docId>

Tips

Confirm before sending emails or creating events
Use --json for scripting-friendly output
Use --no-input to skip confirmations in scripts
Sheets values: use --values-json for complex data
Docs: supports export/cat/copy only - in-place edits need Docs API client

---name: gogdescription: Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docslicense: MIT---## What I doControl Gmail, Calendar, Drive, Contacts, Sheets, and Docs from the command line using `gog`.## Installation```bashbrew install steipete/tap/gogcli```## Setup (one-time)```bash# Authenticate with OAuthgog auth credentials /path/to/client_secret.json# Add account with servicesgog auth add you@gmail.com --services gmail,calendar,drive,contacts,sheets,docs# List accountsgog auth list```## Environment```bash# Set default account to avoid --account flagexport GOG_ACCOUNT=you@gmail.com```## Gmail### Search emails```bashgog gmail search 'newer_than:7d' --max 10gog gmail search 'from:boss@company.com is:unread' --max 20```### Send email```bashgog gmail send --to a@b.com --subject "Hi" --body "Hello"```## Calendar### List events```bashgog calendar events <calendarId> --from 2024-01-01 --to 2024-01-31```## Drive### Search files```bashgog drive search "query" --max 10gog drive search "name contains 'report' and modifiedTime > '2024-01-01'"```## Contacts```bashgog contacts list --max 20```## Sheets### Get values```bashgog sheets get <sheetId> "Tab!A1:D10" --json```### Update values```bashgog sheets update <sheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED```### Append rows```bashgog sheets append <sheetId> "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS```### Clear cells```bashgog sheets clear <sheetId> "Tab!A2:Z"```### Get metadata```bashgog sheets metadata <sheetId> --json```## Docs### Export```bashgog docs export <docId> --format txt --out /tmp/doc.txt```### Cat (print contents)```bashgog docs cat <docId>```## Tips- **Confirm before sending** emails or creating events- Use `--json` for scripting-friendly output- Use `--no-input` to skip confirmations in scripts- Sheets values: use `--values-json` for complex data- Docs: supports export/cat/copy only - in-place edits need Docs API client

Frequently asked questions

Gog