google-workspace

Automating Google Workspace workflows is handled through a gws-based CLI and Python wrapper that orchestrate Gmail, Calendar, Drive, Sheets, Docs, and Contacts. The integration uses OAuth2 with automatic token refresh to maintain continuous access for Hermes agents.

OAuth2 token refresh relies on a bridge script that keeps tokens valid automatically for Hermes agent integrations. This mechanism prevents authentication lapses during multi-service orchestration and includes safety checks for missing credentials and scopes.

Direct gws CLI access supports advanced operations and per-service commands for Gmail, Calendar, Drive, and other Google Workspace services. A backward-compatible Python wrapper also delegates to gws while preserving existing CLI usage patterns.

Managing Google Workspace OAuth tokens requires google-api-python-client along with google-auth-oauthlib and google-auth-httplib2. Running the setup script authenticates with Google and generates an access token to initiate cross-service workflows.

Missing OAuth scopes trigger built-in safety checks that prevent the Google Workspace integration from executing unauthorized operations. The bridge script validates credentials and scopes before attempting token refresh or multi-service orchestration.

Setting up Google Workspace access for Hermes agents involves running a setup script to authenticate with Google and generate an access token. Once authenticated, provided wrappers manage Gmail, Calendar, Drive, Contacts, Sheets, and Docs workflows via the gws CLI.