gws-chat
bygoogleworkspace· 58 skills
Google Chat: Manage Chat spaces and messages.
How to install gws-chat?
googleworkspace/cli/gws-chat
$npx -y skills add googleworkspace/cli --skill gws-chatInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Run `npx skills use "https://github.com/googleworkspace/cli" --skill "googleworkspace/cli/gws-chat"` and follow the generated skill instructions now. Read its complete output, redirecting it to a temporary file first if necessary. Resolve relative paths from the supporting-files directory it provides.
Use the skills in "https://github.com/googleworkspace/cli" that are relevant to the current task. Run `npx skills add "https://github.com/googleworkspace/cli"` and select the relevant skills, then follow their instructions.
SKILL.md
| 1 | # chat (v1) |
| 2 | |
| 3 | > **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it. |
| 4 | |
| 5 | ```bash |
| 6 | gws chat <resource> <method> [flags] |
| 7 | ``` |
| 8 | |
| 9 | ## Helper Commands |
| 10 | |
| 11 | | Command | Description | |
| 12 | |---------|-------------| |
| 13 | | [`+send`](../gws-chat-send/SKILL.md) | Send a message to a space | |
| 14 | |
| 15 | ## API Resources |
| 16 | |
| 17 | ### customEmojis |
| 18 | |
| 19 | - `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). |
| 20 | - `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. |
| 21 | - `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). |
| 22 | - `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). |
| 23 | |
| 24 | ### media |
| 25 | |
| 26 | - `download` — Downloads media. Download is supported on the URI `/v1/media/{+name}?alt=media`. |
| 27 | - `upload` — Uploads an attachment. For an example, see [Upload media as a file attachment](https://developers.google.com/workspace/chat/upload-media-attachments). |
| 28 | |
| 29 | ### spaces |
| 30 | |
| 31 | - `completeImport` — Completes the [import process](https://developers.google.com/workspace/chat/import-data) for the specified space and makes it visible to users. |
| 32 | - `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). |
| 33 | - `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). |
| 34 | - `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. |
| 35 | - `get` — Returns details about a space. For an example, see [Get details about a space](https://developers.google.com/workspace/chat/get-spaces). |
| 36 | - `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/chat/list-spaces). |
| 37 | - `patch` — Updates a space. For an example, see [Update a space](https://developers.google.com/workspace/chat/update-spaces). If you're updating the `displayName` field and receive the error message `ALREADY_EXISTS`, try a different display name.. An existing space within the Google Workspace organization might already use this display name. |
| 38 | - `search` — Returns a list of spaces in a Google Workspace organization based on an administrator's search. In the request, set `use_admin_access` to `true`. For an example, see [Search for and manage spaces](https://developers.google.com/workspace/chat/search-manage-admin). |
| 39 | - `setup` — Creates a space and adds specified users to it. The calling user is automatically added to the space, and shouldn't be specified as a membership in the request. For an example, see [Set up a space with initial members](https://developers.google.com/workspace/chat/set-up-spaces). To specify the human members to add, add memberships with the appropriate `membership.member.name`. To add a human user, use `users/{user}`, where `{user}` can be the email address for the user. |
| 40 | - `members` — Operations on the 'members' resource |
| 41 | - `messages` — Operations on the 'messages' resource |
| 42 | - `spaceEvents` — Operations on the 'spaceEvents' resource |
| 43 | |
| 44 | ### users |
| 45 | |
| 46 | - `sections` — Operations on the 'sections' resource |
| 47 | - `spaces` — Operations on the 'spaces' resource |
| 48 | |
| 49 | ## Discovering Commands |
| 50 | |
| 51 | Before calling any API method, inspect it: |
| 52 | |
| 53 | ```bash |
| 54 | # Browse resources and methods |
| 55 | gws chat --help |
| 56 | |
| 57 | # Inspect a method's required params, types, and defaults |
| 58 | gws schema chat.<resource>.<method> |
| 59 | ``` |
| 60 | |
| 61 | Use `gws schema` output to build your `--params` and `--json` flags. |
Related
6 picksType
- handoffCompact the current conversation into a handoff document for another agent to pick up.Jul 2026
- lark-sharedUse for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing…Jul 2026
- lark-eventLark/Feishu real-time event listening / subscribing / consuming: stream events as NDJSON via `lark-cli event consume <EventKey>` (covers IM…Jul 2026
- lark-vc-agent飞书视频会议会中能力：用于让应用机器人真实加入或离开正在进行的会议，并读取当前身份可见的会中事件、发送会中文本消息或会中表情。适用于用户询问正在开的会议发生了什么、谁在发言、是否共享内容，或需要发现当前可读的进行中会议 ID。不负责已结束会议搜索、参会人快照、纪要、逐字稿或录制查询，这些使用 lark-vc 技能。Jul 2026
- ask-mattAsk which skill or flow fits your situation. A router over the skills in this repo.Jul 2026
- paperclip-create-agentCreate new agents in Paperclip with governance-aware hiring. Use when you need to inspect adapter configuration options, compare existing agent configs, draft…Jul 2026
