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.