platform-google-chat

Connect a self-hosted Hermes agent to Google Chat via Pub/Sub pull subscription.

13|1|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/paarths-collab/hstack --skill platform-google-chat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: platform-google-chat
Source: https://github.com/paarths-collab/hstack/tree/main/skills/platform-google-chat
Command: npx skills add https://github.com/paarths-collab/hstack --skill platform-google-chat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill connects a self-hosted Hermes agent to Google Chat without public webhooks, making enterprise chat integration workable on SSH-managed VPS deployments while keeping access tightly controlled.

Core Features & Use Cases

  • Google Chat wiring: Configures Hermes to receive messages through a Cloud Pub/Sub pull subscription and send replies through the Google Chat API.
  • Safety checks: Verifies the GCP project, topic, subscription, service-account key path, Publisher IAM, and required allowlist before enabling the integration.
  • Operational reliability: Uses idempotent setup steps, dry-run previewing, and rollback-safe gateway reloading so repeated runs stay predictable.
  • Use Case: A team wants their internal Workspace users to DM a Hermes agent in Google Chat and get replies from a VPS-hosted bot without exposing a webhook to the internet.

Quick Start

Use this skill to connect a Hermes agent on your VPS to Google Chat by validating the Pub/Sub setup, writing the required Hermes environment values, and reloading the gateway after the Workspace allowlist is in place.

Frequently Asked Questions about platform-google-chat

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

FAQPage Schema
How do I connect a self-hosted Hermes agent to Google Chat without exposing a public webhook?

Connect Hermes to Google Chat using a Cloud Pub/Sub pull subscription to receive messages and the Google Chat API to send replies. This setup allows a VPS-hosted bot to integrate securely without exposing webhooks to the internet.

What GCP resources do I need to configure before wiring Hermes to Google Chat?

You need a valid GCP project, Pub/Sub topic, pull subscription, and a service-account key path. The setup validates these resources and verifies Publisher IAM permissions before enabling the Google Chat integration.

Can I restrict Google Chat access to specific Workspace users for my VPS-hosted bot?

Yes, you can restrict access by applying an email allowlist. The setup verifies this allowlist alongside GCP project and IAM prerequisites before reloading the gateway to activate the chat integration.

Is it safe to rerun the Google Chat integration setup for my Hermes agent?

Yes, the setup is idempotent and rollback-safe. It uses dry-run previewing and predictable gateway reloading steps, ensuring repeated runs do not disrupt existing configurations.

Does this Google Chat integration work with SSH-managed VPS deployments?

Yes, it is designed specifically for SSH-managed VPS deployments. It connects a self-hosted Hermes agent to Workspace chat safely, applying controlled access through Pub/Sub pull subscriptions rather than public endpoints.