Skip to main content
The Google Chat toolkit connects a Google account to agents and workflows using OAuth and lets you search messages across spaces, list and manage spaces, send and update messages, and add or remove space members. Connecting Google Chat adds Chat scopes to the existing Google OAuth connection without replacing Gmail, Calendar, or Drive access.

​
Prerequisites

  • An active Google Workspace account with access to the Google Chat spaces you intend to use.
  • An agent or workflow where you can configure a toolkit.
  • Your administrator must have configured a Google OAuth integration before you can connect.
Google Chat nodes use resource names, not short IDs. Always use resource names returned by list or get tools — for example spaces/AAAA for a space and spaces/AAAA/messages/BBB for a message. Use Search Messages to find messages by content; List Messages only lists messages in a space chronologically and is not a text search.

​
Setup

1

Open an agent or workflow

Create or open an agent and add the Google Chat toolkit, or add a Google Chat node to a workflow.
2

Connect your Google account

Select the Google sign-in action when prompted and sign in with the Google Workspace account that has access to the Chat spaces the agent should use.
3

Test with read actions first

Run List Spaces to confirm access and get space resource names. Use Search Messages to find messages before attempting any write operations.

​
Available tools

​
Spaces

​
Messages

​
Members

​
Use cases

  • Search a team space for recent mentions of a topic and summarize the findings before sending a follow-up message.
  • Post a workflow result, approval outcome, or automated reminder into a designated Google Chat space.
  • Create a new project space after a form submission or approval, then add the relevant team members.
  • Update a status message in a space after a later workflow step completes successfully.
  • Remove a member from a space when project access is revoked or a project ends.

​
Troubleshooting