google-workspace

Manages Google Workspace access via OAuth with gws or Python fallback.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/gqf2008/hermez-ai --skill google-workspace-gqf2008
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/gqf2008/hermez-ai/tree/main/skills/productivity/google-workspace
Command: npx skills add https://github.com/gqf2008/hermez-ai --skill google-workspace-gqf2008

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?

Hermes needs seamless access to Google Workspace tools (Gmail, Calendar, Drive, Contacts, Sheets, Docs) without requiring manual API setup, while offering a fallback to the Python client when gws is unavailable.

Core Features & Use Cases

  • Google Workspace integration via Hermes-managed OAuth2.
  • Uses the Google Workspace CLI (gws) when available for broader API coverage, with a Python client fallback.
  • Supports Gmail, Calendar, Drive, Contacts, Sheets, and Docs operations through a consistent JSON interface for automation.

Quick Start

Install the Hermes setup to authenticate and begin automating Gmail, Calendar, Drive, Sheets, and Docs with Google Workspace.

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 Gmail and Calendar with OAuth2 authentication?

This Skill handles Google Workspace automation by using Hermes-managed OAuth2 to obtain scoped tokens, allowing automated management of Gmail, Calendar, Drive, Sheets, Docs, and Contacts through a consistent JSON interface.

What is the best way to integrate Google Drive and Sheets into an automated workflow?

The best way to integrate Google Drive and Sheets into an automated workflow is by using the gws CLI for broader API coverage, falling back to Python client libraries like google-api-python-client when gws is unavailable.

Does this Google Workspace integration require manual API setup for Gmail and Docs?

No, it avoids manual API setup by relying on Hermes-managed OAuth2 and token storage, requiring only a non-interactive first-time setup to authenticate and enable access to Gmail and Docs.

Can I use Python client libraries instead of the gws CLI for Google Workspace automation?

Yes, the integration uses a backend switch that automatically falls back to Python client libraries like google-api-python-client and google-auth-oauthlib when the gws CLI is not installed.

What are the limitations of using a non-interactive setup for Google Workspace OAuth tokens?

A limitation of the non-interactive first-time setup is that it requires pre-configured Hermes token storage, meaning you cannot dynamically adjust OAuth scopes or interactively approve access during the workflow.