gws-chat
Lets your agent manage spaces and messages in Google Chat. It's useful for organizing conversations and teams.
What it does
This agent allows you to manage conversations and spaces in Google Chat. You can create, send messages, download or upload files, manage custom emojis, and more.
When to use it
- ✓Send a message to a group.
- ✓Create a new chat space.
- ✓Download a file from a conversation.
Example of what to ask your AI
“Send a message to the 'Project X' space with the text 'Meeting tomorrow at 10 AM'.”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
It connects directly to your Google Chat account. When you ask it to do something, it translates your request into commands that Google Chat understands to perform the action.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add googleworkspace/cli --skill gws-chatOr download just the file:
curl -L https://raw.githubusercontent.com/googleworkspace/cli/main/skills/gws-chat/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
chat (v1)
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
gws chat <resource> <method> [flags]
Helper Commands
| Command | Description |
|---|---|
+send |
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 and Manage custom emoji permissions.delete— Deletes a custom emoji. By default, users can only delete custom emoji they created. Emoji managers assigned by the administrator can delete any custom emoji in the organization. See Learn about custom emojis in Google Chat. 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 and Manage custom emoji permissions.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 and Manage custom emoji permissions.
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.
spaces
completeImport— Completes the import process 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 inImport mode. For an example, see Create a space.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.findDirectMessage— Returns the existing direct message with the specified user. If no direct message space is found, returns a404 NOT_FOUNDerror. For an example, see Find a direct message. With app authentication, 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.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.patch— Updates a space. For an example, see Update a space. If you're updating thedisplayNamefield and receive the error messageALREADY_EXISTS, try a different display name.. An existing space within the Google Workspace organization might already use this display name.search— Returns a list of spaces in a Google Workspace organization based on an administrator's search. In the request, setuse_admin_accesstotrue. For an example, see Search for and manage spaces.
…
FAQ
Do I need a Google Workspace account to use this?
Some features, like custom emojis, require a Google Workspace account and for the administrator to enable this functionality.
How can I see all available commands?
You can type `gws chat --help` to see all the features and commands the agent can perform.
How do I know what information to provide for a command?
Use the command `gws schema chat.<resource>.<method>` to see the necessary details for each action.
Details
Original description by the author
Google Chat: Manage Chat spaces and messages.
repo: googleworkspace/cli
Popularity
- GitHub stars
- 32k
- Ranking position
- #6255
- License
- Apache-2.0
- Updated
- 10/6/2026
Comments
- …
More skills from this repository
gws-admin-reports
Helps your agent get activity reports from Google Workspace. It collects audit and usage data.
googleworkspace/cli
gws-calendar-agenda
Helps your agent see upcoming events across all calendars. It's useful for organizing your schedule and knowing what's coming up.
googleworkspace/cli
gws-calendar-insert
Lets your agent create new events in Google Calendar. It's useful for scheduling appointments and meetings.
googleworkspace/cli
gws-calendar
Allows your agent to manage calendars and events. It's useful for organizing your life and work.
googleworkspace/cli
Similar skills
operator-approval-loop
Makes your agent manage message sending with human approval. It ensures important messages are reviewed before being sent.
affaan-m/ECC
discernment-nudge
Has your agent add follow-up questions after giving an important answer. It's useful for ensuring you think carefully about advice or plans before acting.
anthropics/skills
interview-me
Asks questions to understand exactly what you need. Ensures the agent grasps your real need before starting work.
addyosmani/agent-skills