google-workspace

Facilitates cross-service workflows and manages GUIs via CLI for major web GUIs.

1|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/tangzheng202202/hermes-skills --skill google-workspace-tangzheng202202
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/tangzheng202202/hermes-skills/tree/main/06-productivity/productivity/google-workspace
Command: npx skills add https://github.com/tangzheng202202/hermes-skills --skill google-workspace-tangzheng202202

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Gmail, Calendar, Drive, Sheets, and Docs integration and automation via the gws CLI to streamline Google Workspace workflows within Hermes.

Core Features & Use Cases

  • Unified Gmail, Calendar, Drive, Sheets, and Docs management through a single gws-based CLI workflow.
  • Automatic OAuth2 token refresh via the gws_bridge, ensuring uninterrupted access across services.
  • Scriptable automation for common tasks (send emails, schedule events, manage Drive files) across multiple Google Workspace apps.

Quick Start

Run the setup to authorize Google Workspace access and enable Hermes to manage Gmail, Calendar, Drive, Sheets, and Docs via gws.

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 and scheduling Calendar events?

Cross-service Google Workspace automation is handled through the gws binary and OAuth2 credentials. The google workspace bridge automatically refreshes tokens, ensuring uninterrupted access across Gmail, Calendar, Drive, Sheets, and Docs.

What do I need to set up before managing Drive files and Docs via gws?

You need OAuth2 credentials including google_client_secret.json and google_token.json to authorize gws CLI access. The google workspace bridge uses these to automatically refresh tokens and ensure uninterrupted service access.

How does OAuth2 token refresh work for Gmail and Calendar CLI automation?

OAuth2 token refresh is handled automatically by the google workspace bridge. It uses your google_token.json and google_client_secret.json credentials to maintain uninterrupted access across Gmail, Calendar, Drive, Sheets, and Docs automation workflows.

Can I use a single CLI workflow to manage multiple Google Workspace apps like Sheets and Drive?

Yes, the gws CLI provides a single unified workflow for managing Google Workspace apps including Gmail, Calendar, Drive, Sheets, and Docs. You can script routine cross-service tasks like querying files and sending emails together.

Why does my gws CLI automation for Google Workspace stop working due to authentication errors?

Authentication errors in gws CLI automation typically occur when OAuth2 tokens expire or are invalid. The google workspace bridge exists to refresh tokens automatically, so failures suggest missing or incorrect google_token.json and google_client_secret.json credentials.