google-workspace

Automate Gmail, Calendar, Drive, Sheets, and Docs management via CLI.

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

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 Agent integration to manage Google Workspace services (Gmail, Calendar, Drive, Sheets, Docs) from a unified CLI with OAuth-based authentication.

Core Features & Use Cases

  • CLI wrappers for Gmail, Calendar, Drive, Sheets, and Docs using Google API client or the gws backend for faster operations.
  • Seamless OAuth2 setup flow: store client secrets and tokens under Hermes home, refresh tokens, and support live checks.
  • Use cases include: search Gmail, read/send/reply messages, list and create calendar events, manage Drive files and permissions, read and write Sheets/Docs data.

Quick Start

Run the setup script to authenticate, then use the google_api.py CLI to manage Gmail, Calendar, Drive, Sheets, and Docs.

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 management for Gmail, Calendar, and Drive from a CLI?

You can automate Google Workspace management by using a CLI that wraps the Google API client, enabling Gmail search and send, calendar event creation, and Drive file management. It requires OAuth2 credentials and a local token.

How do I set up OAuth2 authentication for Google API Python client scripts?

OAuth2 setup for Google API Python client scripts requires storing google_client_secret.json and generating a google_token.json under your Hermes home directory. Run the setup script to authenticate and enable automatic token refresh.

Can I read and write Google Sheets and Docs data using Python CLI commands?

Yes, you can read and write Google Sheets and Docs data using Python CLI commands. The integration utilizes the google-api-python-client to access and modify spreadsheet or document content directly from the command line.

Do I need the gws backend installed to manage Gmail and Calendar events?

You do not need the gws backend installed to manage Gmail and Calendar events. The gws CLI is optional and provides faster operations, but standard Google Workspace management works using the core Google API Python client libraries.

What Python dependencies are required for Google Workspace OAuth2 integration?

Google Workspace OAuth2 integration requires three Python dependencies: google-api-python-client, google-auth-oauthlib, and google-auth-httplib2. These libraries handle API requests and OAuth2 authentication flows.

Can I manage Drive file permissions and send Gmail replies with a single CLI tool?

Yes, you can manage Drive file permissions and send Gmail replies with a single CLI tool. The unified interface handles Gmail message replies, Drive permissions, and Calendar events simultaneously through authenticated Google API endpoints.