gws-chat-send skill: have Claude post a message to Google Chat
Lets Claude post a plain-text message to a Google Chat space using the gws command line tool.
- Installs
- 32.3K
- on skills.sh
- Stars
- 32K
- on GitHub
- Updated
- Oct 2026
- last repo commit
gws-chat-send tells Claude how to run one command, gws chat +send, with a space name and the message text. It marks the command as a write and tells Claude to confirm with you before it runs.
It does not talk to Google by itself. It needs the gws tool installed and signed in, and it tells Claude to read a second skill, gws-shared, first for sign-in and safety rules. It sends plain text only. For cards or threaded replies the skill points to the raw API.
Good for
- Teams that live in Google Chat and want Claude to post an update
- Developers who already script Google Workspace from the terminal
- Anyone who wants a status message sent to a space from a prompt
Install gws-chat-send
Claude Code
- 1
Copy this prompt.
Install the gws-chat-send skill in Claude Code. Run this command: npx skills add https://github.com/googleworkspace/cli --skill gws-chat-send --skill gws-shared Then check that it loaded and tell me how to use it.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js, gws installed and signed in.
The skill only tells Claude how to call the gws tool, so gws must be installed and signed in on your machine first. gws-shared is installed too because every gws skill tells Claude to read it for sign-in, global flags and safety rules. The README says gws is not an officially supported Google product.
From the vendor's docs. Source.
What's in the skill
When it loads
Google Chat: Send a message to a space.
Sections in SKILL.md
- Usage
- Flags
- Examples
- Tips
- See Also
Key facts
- Author
- googleworkspace
- Installs on skills.sh
- 32,289 as of Nov 2, 2026
- License
- Apache-2.0
- Last repo commit
- Oct 30, 2026
- What is inside
- 1 file: SKILL.md
- skills.sh audits
- Gen Agent Trust Hub pass, Socket pass, Snyk pass
What it includes
Posts plain text to a Chat space
Takes --space (like spaces/AAAA...) and --text, both required.
Try: “Post 'Deploy finished' to the Chat space spaces/AAAAxxxx.”
Write ·
gws chat +sendFinds the space name to use
The skill's tip for looking up a space name before sending.
Try: “List my Google Chat spaces so I can pick one.”
Network ·
gws chat spaces listClaude asks you before it runs the write command
The skill flags +send as a write command and says to confirm with the user.
Confirm before sendingNot covered; the skill points to the raw API
For cards or threaded replies the Tips section says to use the raw API instead.
Cards and threadsClaude reads this skill first for sign-in and safety rules
SKILL.md opens with a prerequisite note to read ../gws-shared/SKILL.md.
Read ·
gws-shared prerequisite
From the official docs
Permissions
Medium risk
Claude can post messages to a real Google Chat space as you. Check the space and the text before you approve each send.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It posts a real message that others see
The command sends text into a live space. The skill tells Claude to confirm first; read the space name and the text before you approve. github.com
gws is an unofficial tool under active development
The README says gws is not an officially supported Google product and that breaking changes are expected before v1.0. Pin a release if you rely on it. github.com
Security advisories
No published security advisories as of Nov 2, 2026.
Technical details
| Turning on read-only | SKILL.md defines no read-only switch. gws-shared lists a --dry-run flag that validates a command locally without calling the API. |
|---|---|
| Talks to | Google Workspace APIs, called by the gws tool |
| Sign-in and keys | Sign-in is handled by gws, not the skill. The README says interactive credentials are encrypted at rest, with the key in your OS keyring. |
| Scopes |
|
Questions
How do I install gws-chat-send?
Use the install box at the top of this page. It installs this skill together with gws-shared. You also need the gws tool installed and signed in, because the skill only tells Claude which gws commands to run.
Does gws-chat-send need an API key?
No API key is named in the skill. It needs a Google sign-in through gws (gws auth login) and, per the README, a Google Cloud project for the OAuth credentials. gws also supports service accounts and a pre-made access token.
Does gws-chat-send work in the Claude app or Codex?
It needs a terminal where the gws tool runs, so Claude Code is the direct fit. The install box has a Codex tab. The Claude app tab is left out because the skill runs a command on your own machine and the README documents no upload route.
Can it reply in a thread or send a card?
Not with this skill. It sends plain text only, and its tips say to use the raw API for cards or threaded replies.
How do I find the space name?
Ask Claude to run the space list command. The skill's tip says gws chat spaces list shows the names, which look like spaces/AAAA....
Is gws-chat-send safe?
It posts a real message as your Google account, so read the space and the text before you approve. The skill tells Claude to confirm before it runs. The gws README also says gws is not an officially supported Google product.
How is it different from gws-chat?
This skill covers only the +send helper. Its See Also section describes gws-chat as the skill for all the commands that manage chat spaces and messages.
Information
updated Nov 2, 2026
- Repository
- googleworkspace/cli
- Folder
skills/gws-chat-send
Sources
Docs, issue trackers and discussions this page is built from.
Show all 5Hide
- googleworkspace/cli README · github.com
- skills CLI commands · github.com
- gws-shared SKILL.md · github.com
- gws-chat-send SKILL.md · github.com
- skills.sh listing · skills.sh