Back to Skills

gog

Google Workspace CLI for Gmail, Calendar, Drive, and Contacts.

207,196stars37,962forksUpdated 2/18/2026

Security Assessment

Safe(100/100)
Security Score100/100

About gog

The 'gog' skill provides a powerful command-line interface (CLI) for managing various Google Workspace services, including Gmail, Calendar, Drive, Contacts, Sheets, and Docs. It simplifies the process of interacting with these services through simple commands, making it an essential tool for users looking to automate and streamline their workflows without needing to navigate through the web interfaces of these tools. By integrating directly with Google Workspace, 'gog' offers an efficient and flexible way to manage emails, schedule events, manipulate documents, and manage files, all from the terminal.

Main features include email management, such as searching, sending, and managing drafts in Gmail, as well as scheduling, creating, and updating events in Google Calendar. Users can also search files on Google Drive, list and manage contacts, and perform powerful operations on Google Sheets, such as updating, appending, and clearing data. Additionally, users can export and manage documents in Google Docs. With its OAuth-based authentication system, 'gog' ensures secure access to user data, making it ideal for individuals and teams who rely on Google Workspace for their daily operations.

This skill is especially beneficial for developers, system administrators, and power users who are familiar with CLI tools and need quick, automated access to their Google Workspace services. It’s a great fit for anyone who needs to integrate these services into larger automation workflows, such as in continuous integration/continuous deployment (CI/CD) pipelines, or for personal productivity management, enabling them to handle email management, calendar scheduling, and document handling directly from the terminal.

FAQ

How do I authenticate with Google Workspace using 'gog'?

To authenticate with 'gog', use the command 'gog auth credentials /path/to/client_secret.json' to provide your OAuth credentials. Then, use 'gog auth add <email> --services <services>' to add the services you wish to access, such as Gmail, Calendar, Drive, etc.

What services can I access with 'gog'?

With 'gog', you can manage Gmail, Calendar, Drive, Contacts, Sheets, and Docs. This includes tasks such as searching emails, sending messages, creating events, updating files, and exporting documents.

What are the system requirements for using 'gog'?

'gog' requires the installation of the 'gog' binary on your system. It can be installed via Homebrew on macOS using the formula 'steipete/tap/gogcli'. Ensure that you also have OAuth credentials configured for authentication.

Can I use 'gog' to send HTML emails?

Yes, 'gog' supports sending HTML emails by using the '--body-html' flag, allowing you to format the body of your email with HTML tags, such as <p> for paragraphs and <br> for line breaks.

Is there a limit to how many emails I can search or send with 'gog'?

Yes, you can limit the number of emails returned in searches using the '--max' flag. For example, 'gog gmail search --max 10' will return up to 10 emails based on the search criteria.

Install gog

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill