google-chat-connector

Install and operate the Google Chat connector to send and read messages via the Google Chat API.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/selrai-company/claude-workshop-kit --skill google-chat-connector
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-chat-connector
Source: https://github.com/selrai-company/claude-workshop-kit/tree/main/skills/google-chat-connector
Command: npx skills add https://github.com/selrai-company/claude-workshop-kit --skill google-chat-connector

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of installing, authenticating, and operating Google Chat for Google Workspace accounts so users can programmatically list spaces, send messages, reply in threads, and manage team communication without manual UI steps.

Core Features & Use Cases

  • One-time installation and auth: Walks users through installing the Google Workspace CLI (gws), verifying Node.js, and setting up OAuth2 credentials or using an existing client_secret.json.
  • Full Chat operations: List spaces, read messages, send messages or threaded replies, list members, and post rich card messages using the Chat API.
  • Robust fallbacks and safety: Uses Playwright only for UI-only tasks like creating spaces or editing UI settings, enforces read-before-write and confirmation rules, and provides explicit error recovery steps for token and permission issues.
  • Use Case: A product manager can set up the connector, authenticate a Workspace account, and then ask the assistant to post deployment notifications or pull recent discussion threads from a named team space.

Quick Start

Ask the assistant to set up Google Chat by installing gws, authenticating your Workspace account, listing your spaces, and sending a test message to a named space.

Frequently Asked Questions about google-chat-connector

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

FAQPage Schema
How do I automate sending messages to Google Chat spaces?

You can automate sending messages to Google Chat spaces by installing the Google Workspace CLI (gws), authenticating with OAuth2, and using the Chat API to post messages or threaded replies programmatically without manual UI steps.

What do I need to set up before using the Google Chat API with gws?

You need Node.js installed, the @googleworkspace/cli (gws) package, and a Google Workspace OAuth client_secret.json file placed in the ~/.config/gws directory to authenticate before using the Google Chat API.

Can I create Google Chat spaces programmatically using the API?

Creating Google Chat spaces is a UI-only task handled by a Playwright UI fallback rather than the Chat API, allowing automated space creation and UI settings editing within Google Chat.

How do I list Google Chat spaces and read messages via the command line?

You can list Google Chat spaces and read messages via the command line using the gws CLI, which queries the Chat API after OAuth2 authentication to return available spaces and recent discussion threads.

Why does my Google Chat connector fail with token or permission errors?

Google Chat connector token or permission errors typically arise from invalid OAuth2 credentials or expired tokens; the Skill provides explicit error recovery steps to re-authenticate and resolve Workspace permission issues.