Gws Chat
Drive Google Chat spaces and messages from the agent via the `gws chat` CLI instead of hand-crafting API calls.
Overview
Gws Chat is an agent skill for the Build phase that documents how to manage Google Chat spaces and messages with the `gws chat` CLI.
Install
npx skills add https://github.com/googleworkspace/cli --skill gws-chatWhat is this skill?
- `gws chat <resource> <method>` pattern with v1 Chat API surface
- Documents customEmojis create/delete/get and related workspace-admin constraints
- Points to `gws-chat-send` helper for posting messages to a space
- Requires reading shared `gws-shared` auth, flags, and security rules first
- OpenClaw metadata pins `gws` binary and `gws chat --help` for discovery
- Documented as chat API v1 in SKILL frontmatter metadata version 0.22.5
Adoption & trust: 17k installs on skills.sh; 26.9k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You want your coding agent to post or administer Google Chat without memorizing REST paths, auth flags, and resource methods.
Who is it for?
Indie builders on Google Workspace who already standardize on `gws` and need Chat automation from Claude Code, Cursor, or Codex.
Skip if: Users without Workspace Chat, without the `gws` binary, or who only need email or Drive rather than Chat API operations.
When should I use this skill?
User needs to manage Google Chat spaces, messages, or custom emojis through the gws CLI.
What do I get? / Deliverables
The agent can invoke documented Chat resources and methods—and delegate sends via the send helper—using consistent gws auth and security rules.
- Correct `gws chat` invocations for targeted resources and methods
- Handoff to gws-chat-send for space message posting when appropriate
Recommended Skills
Journey fit
Google Chat is an external product hook agents wire in while building tooling and workflows, which maps to Build integrations. The skill documents Chat API resources and helper routes like send-message—classic third-party integration work during product build.
How it compares
CLI skill package for Google Chat via gws—not an MCP server or a hosted notification SaaS.
Common Questions / FAQ
Who is gws-chat for?
Solo builders and small teams using Google Workspace who want agent-driven Chat administration and messaging through the official gws CLI workflow.
When should I use gws-chat?
Use it during Build integrations when you are wiring team notifications, custom emoji management, or space message flows into an agent that already runs `gws`.
Is gws-chat safe to install?
It depends on your gws OAuth scopes and org policies; read gws-shared security rules and review the Security Audits panel on this page before granting network and API access.
SKILL.md
READMESKILL.md - Gws Chat
# chat (v1) > **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it. ```bash gws chat <resource> <method> [flags] ``` ## Helper Commands | Command | Description | |---------|-------------| | [`+send`](../gws-chat-send/SKILL.md) | Send a message to a space | ## API Resources ### customEmojis - `create` — Creates a custom emoji. Custom emojis are only available for Google Workspace accounts, and the administrator must turn custom emojis on for the organization. For more information, see [Learn about custom emojis in Google Chat](https://support.google.com/chat/answer/12800149) and [Manage custom emoji permissions](https://support.google.com/a/answer/12850085). - `delete` — Deletes a custom emoji. By default, users can only delete custom emoji they created. [Emoji managers](https://support.google.com/a/answer/12850085) assigned by the administrator can delete any custom emoji in the organization. See [Learn about custom emojis in Google Chat](https://support.google.com/chat/answer/12800149). Custom emojis are only available for Google Workspace accounts, and the administrator must turn custom emojis on for the organization. - `get` — Returns details about a custom emoji. Custom emojis are only available for Google Workspace accounts, and the administrator must turn custom emojis on for the organization. For more information, see [Learn about custom emojis in Google Chat](https://support.google.com/chat/answer/12800149) and [Manage custom emoji permissions](https://support.google.com/a/answer/12850085). - `list` — Lists custom emojis visible to the authenticated user. Custom emojis are only available for Google Workspace accounts, and the administrator must turn custom emojis on for the organization. For more information, see [Learn about custom emojis in Google Chat](https://support.google.com/chat/answer/12800149) and [Manage custom emoji permissions](https://support.google.com/a/answer/12850085). ### media - `download` — Downloads media. Download is supported on the URI `/v1/media/{+name}?alt=media`. - `upload` — Uploads an attachment. For an example, see [Upload media as a file attachment](https://developers.google.com/workspace/chat/upload-media-attachments). ### spaces - `completeImport` — Completes the [import process](https://developers.google.com/workspace/chat/import-data) for the specified space and makes it visible to users. - `create` — Creates a space. Can be used to create a named space, or a group chat in `Import mode`. For an example, see [Create a space](https://developers.google.com/workspace/chat/create-spaces). - `delete` — Deletes a named space. Always performs a cascading delete, which means that the space's child resources—like messages posted in the space and memberships in the space—are also deleted. For an example, see [Delete a space](https://developers.google.com/workspace/chat/delete-spaces). - `findDirectMessage` — Returns the existing direct message with the specified user. If no direct message space is found, returns a `404 NOT_FOUND` error. For an example, see [Find a direct message](/chat/api/guides/v1/spaces/find-direct-message). With [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app), returns the direct message space between the specified user and the calling Chat app. - `get` — Returns details about a space. For an example, see [Get details about a space](https://developers.google.com/workspace/chat/get-spaces). - `list` — Lists spaces the caller is a member of. Group chats and DMs aren't listed until the first message is sent. For an example, see [List spaces](https://developers.google.com/workspace/cha