google-workspace

Provide OAuth-based access to Google Workspace services via Hermes.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/photonics-dhl/Hermes --skill google-workspace-photonics-dhl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/photonics-dhl/Hermes/tree/main/hermes-home/skills/productivity/google-workspace
Command: npx skills add https://github.com/photonics-dhl/Hermes --skill google-workspace-photonics-dhl

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 gains secure, managed access to Google Workspace services (Gmail, Calendar, Drive, Contacts, Sheets, and Docs) via OAuth, enabling automated workflows and seamless integration.

Core Features & Use Cases

  • Hermes-backed OAuth flow for Google Workspace access across Gmail, Calendar, Drive, Sheets, Docs, and Contacts.
  • Prefers the Google Workspace CLI (gws) as the backend when available for broader API coverage; falls back to the Python client libraries when gws is not installed.
  • Use cases include automating email workflows, calendar events, file operations, and document retrieval from Hermes-driven commands.

Quick Start

Install and authenticate Google Workspace with Hermes by running the setup and following prompts to authorize access for 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 workflows with OAuth authentication?

Google Workspace automation uses an OAuth-based access flow to manage secure authentication for Gmail, Calendar, Drive, Contacts, Sheets, and Docs. It enables automated email, scheduling, and file management workflows through Hermes-backed commands.

Can I use Python client libraries for Google Workspace automation if the gws CLI is unavailable?

Yes, Google Workspace automation falls back to Python client libraries like google-api-python-client when the gws CLI is unavailable. The system prefers gws for broader API coverage but seamlessly switches to Python libraries as a backend.

What Google Workspace services are supported for automation via OAuth?

Supported Google Workspace services include Gmail, Calendar, Drive, Contacts, Sheets, and Docs. OAuth-based access enables automated workflows across email, scheduling, file management, and document retrieval.

Do I need to install the gws CLI to manage Google Workspace access?

No, installing the gws CLI is optional. The system prefers gws for broader API coverage but automatically falls back to Python client libraries using a CLI bridge when gws is not installed.

What's the best way to integrate Gmail and Google Calendar automation into a custom workflow?

Integrating Gmail and Calendar automation is best handled through a Hermes-managed OAuth flow. This approach provides secure, centralized authentication and enables automated email workflows and calendar event management.

Why does my Google Workspace automation fall back to Python client libraries instead of using the CLI?

Google Workspace automation falls back to Python client libraries when the gws CLI is not installed in your environment. The system automatically detects the absence and switches to Python libraries to maintain functionality.