google-workspace

Automate Google Workspace management across Gmail, Calendar, Drive, Docs, Sheets, and Contacts.

2|Updated Apr 25, 2026

Search Tags:#oauth #gmail #docs #calendar #drive #sheets #google-workspace

Ready to run

npx skills add https://github.com/john-data-chen/hermes-agent-backup --skill google-workspace-john-data-chen

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/john-data-chen/hermes-agent-backup/tree/main/skills/productivity/google-workspace
Command: npx skills add https://github.com/john-data-chen/hermes-agent-backup --skill google-workspace-john-data-chen

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 users need a cohesive way to manage Google Workspace services (Gmail, Calendar, Drive, Docs, Sheets, Contacts) within agent workflows, avoiding separate auth flows and manual API calls.

Core Features & Use Cases

Gmail operations: search, read, send, and label management via a unified interface.
Calendar, Drive, Sheets, Docs, and Contacts interactions: listing, creating, updating, and reading data using either gws backend or the Python client.
Real-world scenario: automate weekly email summaries, calendar event batching, and pulling Drive/Docs data into reports with consistent JSON outputs.

Quick Start

Run the setup to authenticate with Google, then use the CLI wrapper (python scripts/google_api.py) to perform Gmail, Calendar, Drive, Sheets, and Docs tasks.

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 tasks without manual API calls?▼

You can automate Google Workspace management by using a bundled Python client and the gws execution backend to handle Gmail, Calendar, Drive, Docs, and Sheets interactions. It performs non-interactive OAuth setup and token management for ongoing automation.

What do I need to set up Google Workspace OAuth for automated workflows?▼

To set up Google Workspace OAuth, you need a Google OAuth client secret stored under the Hermes home directory and a google_token.json token file. Running the provided setup scripts authenticates your account for non-interactive token management.

Can I send emails and manage labels in Gmail through an automated script?▼

Yes, you can perform Gmail operations like searching, reading, sending, and label management through the bundled Python client or gws backend. The CLI wrapper executes these interactions to automate email tasks within workflows.

Does this Google Workspace automation tool support Google Sheets and Docs?▼

Yes, the tool supports Google Sheets and Docs by allowing you to list, create, update, and read data. It uses either the gws execution backend or the bundled Python client to manage these interactions with consistent JSON outputs.

What is the best way to pull Google Drive data into automated reports?▼

The best way to pull Google Drive data into automated reports is using the bundled Python client to read Drive and Docs data, which outputs consistent JSON. This approach avoids separate auth flows and manual API calls for report generation.

Why does my Google Workspace script require a token file?▼

The Google Workspace script requires a google_token.json token file to enable non-interactive OAuth token management for ongoing automation. This maintains authenticated access to Gmail, Calendar, and Drive without requiring repeated manual logins.