google-workspace

Automate Gmail, Calendar, Drive, Contacts, Sheets, and Docs tasks via Hermes-managed OAuth.

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

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 access from Hermes can be complex and manual without a unified integration. This skill provides a centralized OAuth-enabled bridge to Google Workspace services, enabling Hermes to read, manage, and automate common workplace tasks.

Core Features & Use Cases

  • Provides Gmail, Calendar, Drive, Contacts, Sheets, and Docs integration through Hermes with a preference for the Google Workspace CLI (gws) when installed.
  • Supports non-interactive workflows via OAuth, token storage, and a fallback to Python client libraries when gws is not available.
  • Use case: automatically fetch upcoming calendar events and attach them to a project brief, or search Gmail messages from Hermes-enabled bots.

Quick Start

Start by authenticating with Google via the Hermes setup flow, then issue Hermes commands to access 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 integrate Google Workspace services like Gmail and Calendar into my Hermes agent?

You can access Google Workspace services from Hermes by configuring OAuth authentication and utilizing the Google Workspace CLI when installed, or falling back to Python client libraries to manage Gmail, Calendar, Drive, Contacts, Sheets, and Docs tasks.

What do I need to set up OAuth for accessing Gmail and Drive APIs from Hermes?

Accessing Gmail and Drive APIs from Hermes requires a stored OAuth client secret and running Hermes OAuth setup scripts to authenticate and manage tokens for non-interactive workflows.

Can I use Google Workspace CLI with Hermes if the Python client libraries are unavailable?

Hermes prioritizes the Google Workspace CLI (gws) for accessing Workspace services, only falling back to Python client libraries when gws is unavailable.

How does Hermes handle non-interactive workflows for Google Calendar and Sheets?

Hermes manages non-interactive Google Calendar and Sheets workflows via stored OAuth tokens, enabling automated agents to read and manage scheduling and spreadsheet tasks without manual login.

Are there limitations when using the Python client fallback for Google Docs and Contacts access?

Using the Python client fallback for Google Docs and Contacts requires installing the google-api-python-client, google-auth-oauthlib, and google-auth-httplib2 dependencies, unlike the preferred gws CLI approach.