skills.rest
xiaoquqi
xiaoquqiCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

google-workspace

Access Google Workspace services with automatic OAuth token refresh via a gws bridge.

Updated May 1, 2026
Search Tags:#oauth#gmail#calendar#google-workspace#wrapper#token-refresh#gws
One-click install
npx skills add https://github.com/xiaoquqi/hermes-agent-skills --skill google-workspace-xiaoquqi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/xiaoquqi/hermes-agent-skills/tree/main/productivity/google-workspace
Command: npx skills add https://github.com/xiaoquqi/hermes-agent-skills --skill google-workspace-xiaoquqi

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 agents need to access Google Workspace services (Gmail, Calendar, Drive, Contacts, Sheets, Docs) without manual OAuth steps, by wrapping the official gws CLI with automatic token refresh and a dedicated bridge.

Core Features & Use Cases

  • OAuth2 token management and automatic refresh via gws_bridge.py.
  • Backward-compatible Python wrapper (google_api.py) that delegates to gws, preserving Hermes workflows.
  • Supports Gmail, Calendar, Drive, Contacts, Sheets, and Docs; usable from CLI, Telegram, or Discord.
  • Includes a guided setup and references for common tasks such as Gmail searches and calendar operations.

Quick Start

Run the setup to authorize your Google account and then start issuing Hermes Google Workspace commands via the provided wrappers.

Frequently Asked Questions about google-workspace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Gmail and Google Calendar tasks from an AI agent?▼

You can automate Gmail and Google Calendar tasks by wrapping the official gws CLI with a Python bridge that handles automatic OAuth token refresh, enabling direct service management from Hermes agents without manual authentication steps.

Does this Google Workspace wrapper support Google Sheets and Docs automation?▼

Yes, the Google Workspace wrapper supports Google Sheets and Docs automation alongside Gmail, Calendar, Drive, and Contacts, allowing you to manage end-to-end workflows across all these services from CLI, Telegram, or Discord.

Why does my Google Workspace OAuth token expire during automated workflows?▼

Google Workspace OAuth tokens expire due to standard Google API lifecycles, but this skill resolves it by using a dedicated gws_bridge.py script to perform automatic token refresh whenever your Hermes agents access services like Gmail or Drive.

Can I integrate Google Workspace services into Telegram or Discord chat workflows?▼

Yes, you can integrate Google Workspace services into Telegram or Discord chat workflows because the Python wrapper supports chat-based interfaces, enabling you to execute Gmail searches and calendar operations directly from messaging platforms.

What dependencies do I need to manage Google Workspace credentials via Python?▼

To manage Google Workspace credentials via Python, you need the google-api-python-client, google-auth-oauthlib, and google-auth-httplib2 dependencies, which facilitate OAuth2 token management and safe delegation through the provided wrapper.

What is the best way to handle OAuth token refresh for Google API automation?▼

The best way to handle OAuth token refresh for Google API automation is using a dedicated bridge script like gws_bridge.py, which automatically refreshes tokens and delegates requests to gws, preserving your workflow continuity without manual re-authentication.

Related Skills

Explore More Content & Communication Skills→
mishahaninmishahanin
10

google-contacts

Manage Google Contacts records via the People API.

Community
Intermediate
manutejmanutej
61

redis-state-management

Implement Redis caching, sessions, pub/sub, locks, and streams with redis-py.

Community
Advanced
cryptopaficryptopafi

google-workspace

Automates Google Workspace access via Hermes with OAuth2 and automatic token refresh.

Community
Advanced
jacardljacardl

google-workspace

Wrap the gws CLI to integrate Google Workspace services with OAuth token refresh.

Community
Advanced