Skip to content
Skillpedia
Email & messaging32k · #6255

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

https://github.com/googleworkspace/cli/blob/main/skills/gws-chat/SKILL.md

Ready-to-paste message

Use this skill to help me: https://github.com/googleworkspace/cli/blob/main/skills/gws-chat/SKILL.md Read the SKILL.md file at that link and follow its instructions for my task.
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-chat

Or download just the file:

curl -L https://raw.githubusercontent.com/googleworkspace/cli/main/skills/gws-chat/SKILL.md -o SKILL.md
Technical content (original SKILL.md)

Original text by the author, straight from GitHub.

chat (v1)

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

gws chat <resource> <method> [flags]

Helper Commands

Command Description
+send Send a message to a space

API Resources

customEmojis

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 in Import 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 a 404 NOT_FOUND error. 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 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.
  • 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.

…

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

Is this skill useful?

0

Sign in to vote.

Comments

  • …

More skills from this repository

Similar skills