google-workspace

Automate Gmail, Calendar, Drive, Docs, and Sheets via a CLI wrapper with OAuth.

Updated May 2, 2026
One-click install
npx skills add https://github.com/AlvaroBiano/hermes-agent --skill google-workspace-alvarobiano
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/AlvaroBiano/hermes-agent/tree/main/skills/productivity/google-workspace
Command: npx skills add https://github.com/AlvaroBiano/hermes-agent --skill google-workspace-alvarobiano

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires google-api-python-client, google-auth-oauthlib, google-auth-httplib2, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Streamlines the management of Google Workspace apps by providing a Hermes-integrated interface to Gmail, Calendar, Drive, Docs, and Sheets, reducing manual API work and context switching.

Core Features & Use Cases

  • Hermes CLI wrapper for Gmail, Calendar, Drive, Docs, and Sheets with optional gws backend for broader coverage.
  • OAuth-based authentication using google_token.json and google_client_secret.json, featuring a non-interactive setup flow.
  • Cross-platform usage (Linux, macOS, Windows) via the supplied scripts (setup.py, google_api.py) to perform common operations like search, list, create, upload, download, and share.
  • Long-lived token management with automatic refresh and error handling to keep workflows running smoothly.

Quick Start

Install the skill, complete the OAuth setup using the provided tokens, then start issuing commands to manage Gmail, Calendar, Drive, Docs, and Sheets from Hermes.

Frequently Asked Questions about google-workspace

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

FAQPage Schema
How do I automate Google Workspace tasks like sending Gmail or updating Calendar events?

You can automate Google Workspace tasks by using the provided CLI wrapper to interact with Gmail, Calendar, Drive, Docs, and Sheets. It handles API calls and OAuth token management automatically to streamline your workflows.

What do I need to set up OAuth for Google Workspace automation?

To set up Google Workspace OAuth, you need google_client_secret.json and google_token.json credential files. The included setup.py script manages the non-interactive authentication flow to generate long-lived tokens.

Does this Google Workspace automation tool work on Linux, macOS, and Windows?

Yes, this Google Workspace automation tool works across Linux, macOS, and Windows. It uses cross-platform Python scripts to execute commands and manage API interactions consistently.

Can I use Google Workspace automation through Telegram or Discord?

Yes, you can use Google Workspace automation through Telegram or Discord. The skill supports both CLI and programmatic usage, enabling integration with various communication platforms via Hermes.

What is the best way to manage Google Drive files and Google Sheets programmatically?

The best way to manage Drive files and Sheets programmatically is through the provided Python client or optional gws backend. They support common operations like search, list, create, upload, download, and share.

How does token refresh work for Google Workspace API calls?

Token refresh for Google Workspace API calls is handled automatically with built-in error handling. This long-lived token management keeps your automated workflows running smoothly without manual re-authentication.