Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot official · Google

gws-chat-send — Claude skill: send messages to Google Chat

A skill that posts a plain-text message to a Google Chat space from the command line. Useful when your agent needs to notify a team.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add googleworkspace/cli --skill gws-chat-send -a claude-code
Open on GitHub

What gws-chat-send does

The skill wires up gws chat +send with two required flags: --space and --text. The first takes a space name like spaces/AAAA..., the second takes the message body as plain text.

What's inside is the command reference plus a pointer to gws-shared for auth and global flags. You need the gws binary installed and authenticated before this works. Space names are easiest to find with gws chat spaces list.

It's a write command, so the skill tells you to confirm with the user before running it. Cards and threaded replies aren't covered — those go through the raw API. Worth installing if you push notifications into Google Chat from an agent; skip it if you need to read conversations or send anything richer than text.

What it helps with

  • post a message to a Google Chat space from the terminal
  • notify a team that a build finished
  • hand text to an agent for delivery into chat
  • look up a space name before sending
  • fire off a short update without opening a browser

Example prompts for the agent

  • Send 'Hello team!' to spaces/AAAAxxxx
  • Post a note to Google Chat that the deploy went through
  • List the spaces, then send a message to the right one

How to install gws-chat-send

1Skills CLI (Vercel)

npx skills add googleworkspace/cli --skill gws-chat-send -a claude-code

2Manually: put the files in place

~/.claude/skills/gws-chat-send/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gws-chat-send/

From the same set95

The whole set →
gws-gmail official googleworkspace This skill hands your agent Gmail: send mail, read the inbox, reply in a thread. Useful when email work already runs through the gws CLI. Claude Code CX Codex Cursor +1 81,900installs gws-gmail-send official googleworkspace A skill that teaches your agent to send Gmail from the terminal: recipients, subject, body, attachments and drafts. Claude Code CX Codex Cursor +1 74,700installs gws-drive official googleworkspace This skill hands your agent Google Drive through the gws CLI: files, folders, shared drives, comments and access requests. Useful when docs move through code. Claude Code CX Codex Cursor +1 74,500installs gws-shared official googleworkspace This skill gives agents shared rules for gws CLI authentication, flags, and output formats. Use it when working with gws commands. Claude Code CX Codex Cursor +1 66,000installs gws-calendar official googleworkspace Manage Google Calendar events, access rules, and schedules through the gws CLI tool. Claude Code CX Codex Cursor +1 61,100installs gws-sheets official googleworkspace This skill lets an agent read and edit Google Sheets through the CLI. Use it when a coding workflow needs spreadsheet data or table updates. Claude Code CX Codex Cursor +1 58,800installs gws-docs official googleworkspace This skill lets an agent read and update Google Docs through gws. Use it when document changes should happen from an agent chat. Claude Code CX Codex Cursor +1 58,300installs gws-sheets-read official googleworkspace Reads cell values and sheets from Google Spreadsheets via CLI. Useful when an agent needs spreadsheet data without risk of altering it. Claude Code CX Codex Cursor +1 50,600installs

Similar

Questions about gws-chat-send

How do I install gws-chat-send in Claude?

Run npx skills add googleworkspace/cli --skill gws-chat-send -a claude-code. The skill lands at ~/.claude/skills/gws-chat-send/SKILL.md.

What does gws-chat-send do?

It sends a plain-text message to a Google Chat space using gws chat +send --space --text .

What do I need before using it?

The gws binary and auth set up via gws-shared. If that file is missing, run gws generate-skills.

Source text

SKILL.md · Apache-2.0
---
name: gws-chat-send
description: "Google Chat: Send a message to a space."
metadata:
  version: 0.22.5
  openclaw:
    category: "productivity"
    requires:
      bins:
        - gws
    cliHelp: "gws chat +send --help"
---

# chat +send

> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.

Send a message to a space

## Usage

```bash
gws chat +send --space <NAME> --text <TEXT>
```

## Flags

| Flag | Required | Default | Description |
|------|----------|---------|-------------|
| `--space` | ✓ | — | Space name (e.g. spaces/AAAA...) |
| `--text` | ✓ | — | Message text (plain text) |

## Examples

```bash
gws chat +send --space spaces/AAAAxxxx --text 'Hello team!'
```

## Tips

- Use 'gws chat spaces list' to find space names.
- For cards or threaded replies, use the raw API instead.

> [!CAUTION]
> This is a **write** command — confirm with the user before executing.

## See Also

- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
- [gws-chat](../gws-chat/SKILL.md) — All manage chat spaces and messages commands

© googleworkspace · Apache-2.0 · googleworkspace/cli

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor