gog
Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.
About this skill
The `gog` skill provides a comprehensive command-line interface for managing various Google Workspace applications. It allows AI agents to perform operations like searching Gmail, sending emails, managing calendar events, searching and manipulating files in Google Drive, listing contacts, and interacting with Google Sheets (get, update, append, clear, metadata) and Google Docs (export, cat). This skill is designed for programmatic interaction, offering a powerful way to automate tasks that would typically require manual interaction with web interfaces or more complex API integrations. Users can leverage `gog` to automate data extraction from Google Sheets, generate reports from Docs, manage email communications, schedule events, or organize Drive files. Its command-line nature makes it ideal for scripting and integration into automated workflows, enabling agents to perform complex, multi-step operations across Google's suite of productivity tools efficiently. By using `gog`, agents can bypass the need for a browser GUI or custom API client development for many common Google Workspace operations. It streamlines processes, enhances productivity by automating repetitive tasks, and ensures consistent interaction with Google services. The `--json` and `--no-input` flags further optimize it for script-based automation, making it a robust choice for AI-driven task execution.
Best use case
The primary use case for `gog` is automating data management and communication tasks within Google Workspace for individuals or teams. It's particularly beneficial for developers, system administrators, data analysts, and AI agents who need to programmatically access, update, or retrieve information from Gmail, Calendar, Drive, Sheets, and Docs without manual intervention, enabling efficient workflow automation and data synchronization.
Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.
Users should expect efficient, automated execution of Google Workspace tasks, such as sending emails, updating spreadsheets, or retrieving document content, directly via command-line interactions handled by an AI agent.
Practical example
Example input
As an AI agent, I need to find all emails received in the last 7 days that mention 'project update' and list the subjects of the top 3, then create a new calendar event for 'Team Sync' tomorrow at 10 AM for 1 hour.
Example output
Successfully identified 5 emails with 'project update' in the last 7 days. Top 3 subjects: - 'Project Alpha: Weekly Sync' - 'Update on Beta Launch' - 'Q3 Project Review Meeting' Successfully created 'Team Sync' event on your calendar for tomorrow at 10 AM.
When to use this skill
- To automate sending emails or managing calendar events based on triggers.
- When an AI agent needs to programmatically extract or update data in Google Sheets or Docs.
- To search, list, or manipulate files and folders in Google Drive from a script.
- For integrating various Google Workspace operations into broader automation workflows.
When not to use this skill
- For real-time, in-place collaborative editing of Google Docs (as `gog` only supports export, cat, and copy).
- When a rich graphical user interface (GUI) is preferred for interactive, manual use.
- For very complex Google Workspace API interactions that `gog` might not explicitly cover.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/gog-local-backup/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How gog Compares
| Feature / Agent | gog | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | medium | N/A |
Frequently Asked Questions
What does this skill do?
Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.
How difficult is it to install?
The installation complexity is rated as medium. You can find the installation instructions above.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
Top AI Agents for Productivity
See the top AI agent skills for productivity, workflow automation, operational systems, documentation, and everyday task execution.
AI Agents for Freelancers
Browse AI agent skills for freelancers handling client research, proposals, outreach, delivery systems, documentation, and repeatable admin work.
AI Agents for Startups
Explore AI agent skills for startup validation, product research, growth experiments, documentation, and fast execution with small teams.
SKILL.md Source
# gog Use `gog` for Gmail/Calendar/Drive/Contacts/Sheets/Docs. Requires OAuth setup. Setup (once) - `gog auth credentials /path/to/client_secret.json` - `gog auth add you@gmail.com --services gmail,calendar,drive,contacts,sheets,docs` - `gog auth list` Common commands - Gmail search: `gog gmail search 'newer_than:7d' --max 10` - Gmail send: `gog gmail send --to a@b.com --subject "Hi" --body "Hello"` - Calendar: `gog calendar events <calendarId> --from <iso> --to <iso>` - Drive search: `gog drive search "query" --max 10` - Contacts: `gog contacts list --max 20` - Sheets get: `gog sheets get <sheetId> "Tab!A1:D10" --json` - Sheets update: `gog sheets update <sheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED` - Sheets append: `gog sheets append <sheetId> "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS` - Sheets clear: `gog sheets clear <sheetId> "Tab!A2:Z"` - Sheets metadata: `gog sheets metadata <sheetId> --json` - Docs export: `gog docs export <docId> --format txt --out /tmp/doc.txt` - Docs cat: `gog docs cat <docId>` Notes - Set `GOG_ACCOUNT=you@gmail.com` to avoid repeating `--account`. - For scripting, prefer `--json` plus `--no-input`. - Sheets values can be passed via `--values-json` (recommended) or as inline rows. - Docs supports export/cat/copy. In-place edits require a Docs API client (not in gog). - Confirm before sending mail or creating events.
Related Skills
agent-autonomy-kit
Stop waiting for prompts. Keep working.
Meeting Prep
Never walk into a meeting unprepared again. Your agent researches all attendees before calendar events—pulling LinkedIn profiles, recent company news, mutual connections, and conversation starters. Generates a briefing doc with talking points, icebreakers, and context so you show up informed and confident. Triggered automatically before meetings or on-demand. Configure research depth, advance timing, and output format. Walking into meetings blind is amateur hour—missed connections, generic small talk, zero leverage. Use when setting up meeting intelligence, researching specific attendees, generating pre-meeting briefs, or automating your prep workflow.
obsidian
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli. And also 50+ models for image generation, video generation, text-to-speech, speech-to-text, music, chat, web search, document parsing, email, and SMS.
Obsidian CLI 探索记录
Skill for the official Obsidian CLI (v1.12+). Complete vault automation including files, daily notes, search, tasks, tags, properties, links, bookmarks, bases, templates, themes, plugins, sync, publish, workspaces, and developer tools.
📝 智能摘要助手 (Smart Summarizer)
Instantly summarize any content — articles, PDFs, YouTube videos, web pages, long documents, or pasted text. Extracts key points, action items, and insights. Use when you need to quickly digest long content, create meeting notes, or extract takeaways from any source.
Customer Onboarding
Systematically onboard new clients with checklists, welcome sequences, milestone tracking, and success metrics. Reduce churn by nailing the first 90 days.
CRM Manager
Manages a local CSV-based CRM with pipeline tracking
Invoice Generator
Creates professional invoices in markdown and HTML
Productivity Operating System
You are a personal productivity architect. Your job: help the user design, execute, and optimize their daily system so they consistently ship high-impact work while protecting energy and avoiding burnout.
Product Launch Playbook
You are a Product Launch Strategist. You guide users through planning, executing, and optimizing product launches — from pre-launch validation through post-launch growth. This system works for SaaS, physical products, services, marketplaces, and content products.
Procurement Manager
You are a procurement specialist agent. Help teams evaluate vendors, manage purchase orders, negotiate contracts, and optimize spend.
Procurement Operations Agent
You are a procurement operations analyst. When the user provides company details, run a full procurement assessment.