google-workspace

Automate Gmail, Calendar, Drive, Contacts, Sheets, and Docs via Python with OAuth2 token management.

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

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

  • OAuth-based access to Gmail, Calendar, Drive, Sheets, Docs, and Contacts from Hermes Agent.
  • CLI wrappers and Python API access to perform common tasks (search, read, send emails; list/create calendar events; search Drive files; access Contacts; read Docs; manage Sheets).
  • Suitable for automating administrative workflows, cross-platform interactions (CLI, Telegram, Discord), and building multi-service automation pipelines.

Quick Start

Run the setup.py 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 Gmail, Calendar, and Drive workflows using Python?

Google Workspace automation via Python enables batch operations like sending emails and creating calendar events. It provides CLI wrappers and API access to manage Gmail, Drive, Sheets, Docs, and Calendar programmatically.

How does OAuth2 token management work for Google Workspace Python scripts?

OAuth2 token management uses an interactive setup flow with PKCE to authorize and refresh access tokens. It runs entirely on Google's Python client libraries in your local venv, eliminating the need for external binaries.

Can I use this Google Workspace Python API wrapper in Telegram or Discord bots?

Yes, this Google Workspace Python API wrapper supports cross-platform interactions in CLI, Telegram, or Discord contexts. It enables developers to build multi-service automation pipelines within these chat platforms.

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

No external binaries are needed to run Google Workspace automation scripts with Python. The implementation runs entirely using Google's Python client libraries like google-api-python-client within the Hermes venv.

What's the best way to batch read Docs and manage Sheets via a Python CLI?

The best way to batch read Docs and manage Sheets is using the google_api.py CLI wrapper. It automates search, read, and management operations across Google Workspace services with automatic OAuth2 token refresh.

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

Limitations include dependencies on specific packages like google-auth-oauthlib and google-auth-httplib2. Complex batch operations require running setup.py first to authenticate and authorize access before managing services.