google-workspace

Provides OAuth-based access to Google Workspace APIs with token management and CLI.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/dawsonblock/HERMY --skill google-workspace-dawsonblock
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/dawsonblock/HERMY/tree/main/hermes-agent-2026.4.23/skills/productivity/google-workspace
Command: npx skills add https://github.com/dawsonblock/HERMY --skill google-workspace-dawsonblock

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, Sheets, Docs, and Contacts access for Hermes requires secure, seamless authentication and a reliable interface. This integration handles OAuth provisioning, token storage and refresh, and provides CLI wrappers to interact with Google Workspace services from Hermes workflows.

Core Features & Use Cases

  • OAuth-based authentication with token persistence and refresh handling.
  • Flexible backend: use Google Workspace CLI (gws) when available, with a Python client fallback otherwise.
  • End-to-end workflows for Gmail, Calendar, Drive, Sheets, Docs, and Contacts with robust error handling and helpful messaging.

Quick Start

Run the setup to authenticate with Google Workspace through Hermes, then use the CLI to manage Gmail, Calendar, Drive, 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 Google Workspace API access for Hermes workflows?

This Skill automates Google Workspace API access for Hermes by managing OAuth tokens, handling scope provisioning, and providing CLI wrappers for Gmail, Calendar, Drive, Sheets, Docs, and Contacts workflows.

How does OAuth token management work for Google Calendar and Gmail integrations?

OAuth token management handles secure authentication, token storage, and automatic refresh for Google Calendar and Gmail integrations. This ensures seamless, persistent access without requiring manual reauthorization during your workflows.

Do I need the Google Workspace CLI installed to use this integration?

No, you do not need the Google Workspace CLI installed. The Skill features a flexible backend that uses the gws CLI when available, and automatically falls back to a Python client to maximize compatibility.

Can I manage Google Drive and Docs files using Python client fallbacks?

Yes, you can manage Google Drive and Docs files using the Python client fallback. When the gws CLI is not installed, the Skill utilizes google-api-python-client to execute workflows reliably.

What is the best way to handle authentication errors when accessing Google Contacts?

The best way to handle authentication errors when accessing Google Contacts is through the Skill's robust error reporting and helpful messaging. It manages scope handling and token refresh to prevent common authentication failures.

Are there limitations when using Python clients instead of the gws CLI for Google Sheets?

There are no strict limitations, as the Python client fallback ensures end-to-end execution for Google Sheets. However, using the gws CLI when available may offer a more native interface compared to the Python client fallback.