gog

Operate Gmail, Calendar, Drive, Docs, Sheets, and Contacts through the local gog CLI.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/jamsdoescode/Erik-s-Portfolio --skill gog-jamsdoescode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gog
Source: https://github.com/jamsdoescode/Erik-s-Portfolio/tree/main/openclicky/AppResources/OpenClicky/OpenClickyBundledSkills/gog
Command: npx skills add https://github.com/jamsdoescode/Erik-s-Portfolio --skill gog-jamsdoescode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working with Google Workspace normally requires slow browser automation or manual clicking through Gmail, Calendar, and Drive. This Skill routes those tasks through the local gog CLI, giving fast, scriptable, JSON-structured access to your Google account while enforcing strict safety rules around sends and writes. ## Core Features & Use Cases - Gmail read and search: Search threads and messages, fetch message content, and list labels with structured JSON output. - Calendar, Drive, and Contacts access: List upcoming events, search Drive files, and look up contacts without opening a browser. - Guarded Gmail sending: Drafts are shown for explicit approval before any send, and sends only proceed when the account already has send permission. - Auth diagnostics: Inspect authentication status and OAuth credentials before assuming Google Workspace is unavailable. - Use Case: Ask for a summary of unread email from the last 7 days, and the Skill runs gog gmail search with filters, then summarizes the results instead of dumping raw JSON. ## Quick Start Ask the assistant to show your calendar events for the next 7 days using gog.

Frequently Asked Questions about gog

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

FAQPage Schema
How do I search Gmail from the command line?

Use gog gmail search with a query such as "newer_than:7d" plus --max and --account flags, and add --json for structured output. For individual messages, use gog gmail messages search and gog gmail get with the message ID.

How do I list Google Calendar events without opening the browser?

Run gog calendar events with flags like --today or --days 7 to list upcoming events as JSON. You can also use gog calendar search with a keyword to find specific events across your calendars.

Can gog send email automatically?

No, sending is guarded by default. The Skill drafts the email, shows account, recipient, subject, and body for explicit approval, and only sends if the account already has Gmail send permission; the GOG_GMAIL_NO_SEND guard stays on otherwise.

Why does gog auth status show no authenticated account?

The file-keyring backend may be missing its passphrase, which must be available as GOG_KEYRING_PASSWORD, or no account has been added yet. Check both gog auth status and gog auth credentials list, since status alone can misreport credential state.

When should I use browser automation instead of gog?

Use the browser only when gog cannot cover the requested action, the user explicitly wants a visible UI, or a signed-in Google web app is already open and the local connector is unavailable. gog also does not cover Google Cloud, Google Ads, or web search.