gog

Automates Gmail, Calendar, Drive, Contacts, Sheets, and Docs operations via the gog CLI.

Updated Jun 19, 2026
One-click install
npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill gog-amirulandalib
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gog
Source: https://github.com/AmirulAndalib/Vilvona-AI/tree/main/skills/gog
Command: npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill gog-amirulandalib

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Google Workspace services like Gmail, Calendar, Drive, and Sheets normally requires switching between web interfaces or writing custom API integrations. This Skill provides a single command-line interface to search, send, create, and update data across all these services. ## Core Features & Use Cases - Gmail Operations: Search threads or individual messages, send plain-text or HTML emails, create drafts, and reply to existing messages. - Calendar & Sheets Management: List and create calendar events with color coding, and read, update, append, or clear Google Sheets ranges with JSON output. - Drive, Docs & Contacts: Search Drive files, export or read Docs content, and list contacts from one tool. - Use Case: Imagine you need to email a weekly report. Use this Skill to pull figures from a Google Sheet, draft a formatted email with the results, and send it to your team, all through scripted commands. ## Quick Start Ask the assistant to search your Gmail for messages from the last 7 days and summarize the results using the gog CLI.

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 --body-file with a file path or use --body-file - to read from stdin, and use --body-html for rich formatting.

How do I update Google Sheets from a script?

Use gog sheets update with the sheet ID, a range like Tab!A1:B2, and --values-json containing a JSON array of rows. You can also append rows with gog sheets append or read data with gog sheets get --json.

Does gog require OAuth setup before use?

Yes, gog requires one-time OAuth configuration. Run gog auth credentials with your client_secret.json file, then gog auth add with your Google account and the services you need such as gmail, calendar, drive, contacts, docs, and sheets.

What is the difference between gog gmail search and messages search?

gog gmail search returns one row per thread, grouping related emails together. Use gog gmail messages search when you need every individual email returned separately, ignoring thread grouping.

Can gog edit Google Docs content directly?

No, gog only supports exporting, reading, and copying Docs via gog docs export and gog docs cat. In-place edits require a dedicated Google Docs API client, which gog does not provide.