gws-chat-send
googleworkspace/cli
Send plain text messages to Google Chat spaces via CLI.
What is gws-chat-send?
This skill sends a simple text message to a specified Google Chat space using the Google Workspace CLI. Use it when you need to programmatically post notifications, alerts, or messages to team spaces.
- Send plain text messages to Google Chat spaces
- Specify target space by name (e.g., spaces/AAAA...)
- Execute via command-line with required flags
- Integrate messaging into automated workflows
How to install gws-chat-send
npx skills add null --skill gws-chat-send- Google Workspace CLI (gws) installed and configured
- Valid Google Workspace authentication (see gws-shared)
- Space name or ID (retrieve via 'gws chat spaces list')
How to use gws-chat-send
- 1.Retrieve the target space name using 'gws chat spaces list'
- 2.Run 'gws chat +send --space <SPACE_NAME> --text <MESSAGE>'
- 3.Replace <SPACE_NAME> with the space identifier (e.g., spaces/AAAA...)
- 4.Replace <MESSAGE> with your plain text message
- 5.Confirm execution before sending (write operation)
Use cases
- Send automated alerts or notifications to team spaces
- Post status updates from scripts or CI/CD pipelines
- Notify team members of completed tasks or events
- Integrate Google Chat messaging into agent workflows
- DevOps engineers automating notifications
- Developers building chat integrations
- Teams using Google Workspace for communication
- Automation engineers setting up alert systems
gws-chat-send FAQ
Run 'gws chat spaces list' to see all available spaces and their names in the format spaces/AAAA...
No, this skill only supports plain text messages. For cards or threaded replies, use the raw Google Chat API instead.
This is a write command, so you should confirm with the user before executing it.
You need valid Google Workspace authentication configured via the gws CLI (see gws-shared SKILL.md for details).
Full instructions (SKILL.md)
Source of truth, from googleworkspace/cli.
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.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
Send a message to a space
Usage
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
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 — Global flags and auth
- gws-chat — All manage chat spaces and messages commands
Related skills
More from googleworkspace/cli and the wider catalog.
gws-gmail
Send, read, and manage Gmail emails via Google Workspace CLI.
gws-drive
Manage Google Drive files, folders, and shared drives via CLI.
gws-docs
Read and write Google Docs via command line.
gws-calendar
Manage Google Calendar events, calendars, and access control via CLI.
gws-sheets
Read and write Google Sheets spreadsheets via CLI.
gws-gmail-send
Send emails via Gmail with attachments, CC/BCC, HTML support, and draft options.