google-workspace

Automate Google Workspace workflows via authenticated API calls with JSON outputs.

19|4|Updated Apr 22, 2026
One-click install
npx skills add https://github.com/carterwayneskhizeine/hermes-agent-windows-R --skill google-workspace-carterwayneskhizeine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/carterwayneskhizeine/hermes-agent-windows-R/tree/main/skills/productivity/google-workspace
Command: npx skills add https://github.com/carterwayneskhizeine/hermes-agent-windows-R --skill google-workspace-carterwayneskhizeine

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?

This Skill removes the friction of manually working across Gmail, Calendar, Drive, Contacts, Sheets, and Docs by providing Hermes-mediated OAuth and a consistent JSON command interface.

Core Features & Use Cases

  • Non-interactive OAuth setup with refresh: Authenticates once and then automatically refreshes tokens for ongoing use.
  • Unified, JSON-based Google operations: Search and retrieve Gmail content, list/create/delete Calendar events, search Drive files, list Contacts, and read/update/append Sheets ranges.
  • Backend-optimized execution: Uses the gws CLI when available for broader coverage and performance, while falling back to Python Google API clients when gws is not installed.
  • Use Case: A team can search for unread messages with specific labels, summarize relevant emails, pull upcoming meeting events, and update a shared Sheet with action items—all through consistent JSON outputs.

Quick Start

Run the OAuth setup flow by calling the skill’s setup script and then use the API wrapper to execute a Gmail search for unread messages.

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

You can automate Google Workspace workflows by executing authenticated API calls that return consistent JSON outputs, enabling tasks like querying unread email, listing calendar events, and updating spreadsheet ranges.

Do I need OAuth credentials to read and update Google Sheets ranges via API?

Yes, you need OAuth client credentials to authenticate. The system uses a PKCE-based authorization exchange and stores a token at your Hermes home directory for non-interactive token refresh.

Can I use a CLI integration to search Gmail and retrieve message bodies?

Yes, the system routes operations through the gws CLI when installed for broader coverage and performance, falling back to Python Google API clients when the gws CLI is not available.

What is the best way to sync unread Gmail messages and upcoming Calendar events into a shared Sheet?

You can sync this data by querying unread messages, pulling upcoming meeting events, and updating a shared Sheet with action items, all through a unified JSON-based command interface.

Does this Google Workspace automation approach work with Contacts and Google Drive files?

Yes, it supports searching Drive files and listing Contacts through the same authenticated API calls, ensuring consistent JSON outputs across Gmail, Calendar, Drive, Contacts, Sheets, and Docs.

Why does my Google Workspace API integration require a stored token?

A stored token is required to preserve the JSON contract and automatically refresh authentication for ongoing use, eliminating the need for repeated manual OAuth setup across your workflows.