google-workspace

Automates Gmail, Calendar, Drive, Sheets, Docs, and Contacts via Python CLI with OAuth2.

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

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?

Gmail, Calendar, Drive, Contacts, Sheets, and Docs integration via Python. Uses OAuth2 with automatic token refresh. No external binaries needed — runs entirely with Google's Python client libraries in the Hermes venv.

Core Features & Use Cases

  • OAuth2 with automatic token refresh and non-interactive setup for CLI/Telegram/Discord integrations.
  • Unified Python scripts to manage Gmail, Calendar, Drive, Sheets, Docs, and Contacts from Hermes.
  • Real-world use case: automate weekly status reports by aggregating calendar events and Drive documents and emailing summaries.

Quick Start

Start by running the setup script to authenticate with Google, then use the provided CLI wrappers to perform Gmail, Calendar, Drive, Sheets, and Docs operations.

Frequently Asked Questions about google-workspace

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

FAQPage Schema
How do I automate Gmail, Calendar, and Drive operations using Python?

Google Workspace apps like Gmail, Calendar, and Drive are automated via Python using a unified CLI with OAuth2 authentication. It enables cross-service workflows such as reading emails, managing calendar events, and manipulating files entirely through Google's Python client libraries.

Do I need external binaries to run Google Workspace Python scripts?

No external binaries are needed to run Google Workspace automation scripts. The execution happens entirely within the Hermes Python virtual environment using the google-api-python-client, google-auth-oauthlib, and google-auth-httplib2 libraries.

How does OAuth2 authentication work for Google Workspace CLI automation?

OAuth2 authentication for Google Workspace CLI automation uses a PKCE flow with automatic token refresh and a local token store. This enables non-interactive setup suitable for integrations with Telegram or Discord after an initial setup script is executed.

Can I build cross-service workflows that combine Google Calendar events and Drive documents?

Cross-service workflows combining Google Calendar and Drive are fully supported through unified Python scripts. A real-world use case includes aggregating calendar events and Drive documents to automatically generate and email weekly status report summaries.

What is the best way to manage Google Sheets and Docs from a command line interface?

Managing Google Sheets and Docs from a CLI is handled through Python wrapper scripts that interface with Google's API client. This approach provides programmatic document manipulation capabilities without requiring manual interaction with the web interface.