google-workspace

Automate Google Workspace workflows across Gmail, Calendar, Drive, Sheets, Docs, and Contacts via a Python CLI.

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

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?

Automates Google Workspace tasks across Gmail, Calendar, Drive, Sheets, Docs, and Contacts from Hermes, reducing manual scripting and integration overhead.

Core Features & Use Cases

  • OAuth2-based authentication with automatic token refresh to keep access seamless.
  • CLI access via scripts/setup.py and scripts/google_api.py to perform Gmail, Calendar, Drive, Contacts, Sheets, and Docs operations.
  • Fully non-interactive, Hermes-driven workflows suitable for CLI, Telegram, Discord, or any platform integration.

Quick Start

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

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 across Gmail, Calendar, and Drive?

You can automate cross-service Google Workspace tasks by using a Python CLI to perform authenticated API operations like search, read, create, and modify across Gmail, Calendar, Drive, Sheets, Docs, and Contacts.

What do I need to set up OAuth2 authentication for Google Workspace APIs?

You need Google OAuth client credentials and a stored token, specifically google_client_secret.json and google_token.json, plus the Hermes venv and the scripts/google_api.py tooling to establish non-interactive OAuth2 access.

Can I run non-interactive Google Calendar and Gmail workflows from a CLI?

Yes, this setup enables fully non-interactive, Hermes-driven workflows suitable for CLI, Telegram, Discord, or any platform integration using scripts/setup.py and scripts/google_api.py for automated execution.

Does the Google Workspace automation handle automatic token refresh?

Yes, it features OAuth2-based authentication with automatic token refresh to keep your access to Google Workspace services seamless without requiring repeated manual reauthorization.

What Python dependencies are required to manage Google Sheets and Docs programmatically?

You need the google-api-python-client, google-auth-oauthlib, and google-auth-httplib2 Python dependencies to manage Google Sheets, Docs, and Contacts programmatically through the API.

Are there limitations when using OAuth2 for cross-service Google Workspace automation?

The main constraint is the strict requirement for pre-configured google_client_secret.json and google_token.json files, meaning initial setup requires interactive authentication before non-interactive Hermes-driven workflows can execute.