google-chat-messages

Send Google Chat webhook messages with text, cardsV2, and threaded replies.

989|102|Updated Oct 20, 2025
One-click install
npx skills add https://github.com/jezweb/claude-skills --skill google-chat-messages
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: google-chat-messages
Source: https://github.com/jezweb/claude-skills/tree/main/plugins/integrations/skills/google-chat-messages
Command: npx skills add https://github.com/jezweb/claude-skills --skill google-chat-messages

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

Posting notifications to Google Chat requires learning its non-standard formatting syntax, the cardsV2 JSON structure, and threading parameters, which are easy to get wrong and produce 400 errors or broken cards.

Core Features & Use Cases

  • Text and Rich Card Messages: Send formatted text or structured cardsV2 messages with headers, sections, widgets, buttons, and images via incoming webhooks.
  • Threaded Conversations: Group related messages using threadKey and the REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD option for ongoing updates like deployments or alerts.
  • Ready-to-Use TypeScript Utilities: Includes typed card builder and webhook sender utilities with error handling, plus a full widget and known-icon reference.
  • Use Case: A CI pipeline finishes a production deployment and posts a card to a Google Chat space showing environment, version, and health status, with a button linking to the deployment dashboard, threaded under the day's deploy thread.

Quick Start

Ask Claude to send a Google Chat notification card to your space's webhook URL announcing a completed deployment with a View Dashboard button.

Frequently Asked Questions about google-chat-messages

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

FAQPage Schema
How do I send a message to Google Chat from a script?▼

Create an incoming webhook in your Google Chat space settings, then POST a JSON body with a text or cardsV2 field to that URL. The included webhook-sender.ts utility handles the POST request and error reporting.

How do I create a Google Chat card with buttons?▼

Use the cardsV2 format with a card containing a header and sections, then add a buttonList widget whose buttons define onClick openLink URLs. The card-builder.ts utility assembles this structure from typed options.

Does Google Chat support Markdown formatting?▼

Google Chat does not support standard Markdown. Use single asterisks for bold, underscores for italic, tildes for strikethrough, backticks for code, and the <url|text> syntax for links instead of [text](url).

How do I thread replies in Google Chat webhooks?▼

Assign a consistent threadKey string in the message body and append messageReplyOption=REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD to the webhook URL for replies. Messages sharing a threadKey are grouped into one thread.

Why does my Google Chat webhook return a 400 error?▼

A 400 error usually means malformed JSON, such as a missing top-level text or cardsV2 field, or a card section with no widgets. Validate the message structure against the cardsV2 schema before sending.