google-workspace

Authenticate and coordinate Google Workspace services via OAuth2 with automatic token refresh.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/KarlinskyS/hermesSkills --skill google-workspace-karlinskys
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/KarlinskyS/hermesSkills/tree/main/productivity/google-workspace
Command: npx skills add https://github.com/KarlinskyS/hermesSkills --skill google-workspace-karlinskys

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?

Automate routine Google Workspace tasks (Gmail, Calendar, Drive, Sheets, Docs, and Contacts) from Hermes with a streamlined OAuth2 flow and automatic token refresh, eliminating manual setup and external binaries.

Core Features & Use Cases

  • Gmail: search, read, send, reply, and label management.
  • Calendar: list and create events.
  • Drive: list and search files.
  • Sheets & Docs: read data from Sheets and Documents.
  • Contacts: read contact information via People API.

Quick Start

Authenticate once via the setup flow, then operate Gmail, Calendar, Drive, Sheets, and Docs with the gws CLI.

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 tasks like Gmail and Calendar in Hermes?

You can automate Google Workspace tasks by using an OAuth2 integration with automatic token refresh to coordinate Gmail, Calendar, Drive, Sheets, Docs, and Contacts directly within Hermes-embedded environments.

Do I need Google API client libraries to read Sheets and Docs data?

Yes, reading Sheets and Docs data requires the Google API client libraries, specifically google-api-python-client and google-auth-oauthlib, to authenticate and interact with the Workspace APIs.

How does OAuth2 token refresh work for Google Workspace APIs?

OAuth2 token refresh is handled automatically using the refresh_token.py utility, which manages the stored Hermes token to maintain continuous access to Google Workspace APIs without manual re-authentication.

Can I search Gmail and list Drive files from a single CLI?

Yes, after completing a one-time authentication setup, you can use the gws CLI to search and read Gmail, list and search Drive files, and manage Calendar events from a single interface.