google-workspace

Automate Gmail, Calendar, Drive, Docs, and Sheets operations via Hermes CLI.

13|3|Updated May 12, 2026
One-click install
npx skills add https://github.com/kevinnft/ai-agent-skills --skill google-workspace-kevinnft
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/kevinnft/ai-agent-skills/tree/main/skills/productivity/google-workspace
Command: npx skills add https://github.com/kevinnft/ai-agent-skills --skill google-workspace-kevinnft

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?

Programmers and teams need reliable, scriptable access to Gmail, Calendar, Drive, Docs, and Sheets from Hermes without juggling multiple APIs or manual OAuth flows.

Core Features & Use Cases

  • Backend flexibility: uses gws when available for broad Google Workspace coverage, with a Python client fallback for environments without gws.
  • OAuth flow management: includes setup, auth URL generation, code exchange, and token handling to keep credentials current.
  • CLI-driven operations: provides commands to perform common Workspace tasks (email, calendar events, file queries, document reads) from Hermes across platforms (CLI, bots, etc.).

Quick Start

Run the Hermes setup flow to authenticate with Google Workspace and enable CLI access to Gmail, Calendar, Drive, Docs, and Sheets.

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 operations like Gmail and Calendar management from a CLI?

You can automate Google Workspace operations by using scriptable CLI commands to handle email, calendar events, and file queries. This approach provides reliable access to Gmail, Calendar, Drive, Docs, and Sheets without manual OAuth flows.

How does OAuth flow management work for backend Google Workspace integration?

OAuth flow management for Google Workspace integration handles setup, auth URL generation, code exchange, and token storage to keep credentials current. A token file is stored at the Hermes home directory to maintain persistent authentication.

Do I need a Python client to interact with Google Workspace APIs if gws is unavailable?

If the gws backend is unavailable, a Python client fallback using google-api-python-client handles Google Workspace API calls. This backend flexibility ensures broad service coverage across environments lacking the primary gws package.

Can I use Google Workspace scripts to manage document workflows across Telegram or other platforms?

Google Workspace scripts support automated document workflows across CLI, Telegram, and other platforms. CLI-driven operations allow you to perform common tasks like reading documents and managing calendar events from various bot interfaces.

What is needed to set up Google Drive and Gmail API access via Hermes?

Setting up Google Drive and Gmail API access requires a Google OAuth client secret and a generated token file. Running the Hermes setup flow authenticates your credentials and enables CLI access to Workspace services.

What are the limitations of using Python client fallbacks for Google Workspace automation?

The Python client fallback for Google Workspace automation requires specific dependencies like google-auth-oauthlib and google-auth-httplib2. While functional, it serves as a secondary option when the dedicated gws backend is not available.