How a Google Chat agent works with CatalEx
You create a Google Chat app in your own Google Cloud project and give CatalEx two files from it: a service-account key and an OAuth client. CatalEx Cloud then carries messages between Google Chat and your agent on your Mac. Mention the app in a space, or message it directly, and the reply comes back in Google Chat.
The app guides you through six numbered steps, each with the text to copy and a time estimate. File uploads can be turned on so people can share files with the agent.
How to add your agent to Google Chat
- Install CatalEx. Download CatalEx for Mac and sign in with Google.
- Add your agent. Point CatalEx at your agent's folder and check it answers. Add an agent.
- Create the Google Chat app. Open Add channel, choose Google Chat, then New, and follow the six steps. You will need a service-account key and an OAuth client from Google Cloud. Connect Google Chat.
- Message it. Mention the app in a space or send it a direct message.
What teams use a Google Chat agent for
- Internal help desk for teams on Google Workspace: policies, how-tos and account questions.
- Operations. Ask for a report, a status or a summary in a space.
- Engineering. The same agent your engineers use in the terminal, available to the rest of the company.
Frequently asked questions
How do I add an AI agent to Google Chat?
Install CatalEx, add your Claude Code or Codex agent, then add a Google Chat channel. CatalEx walks you through creating a Google Chat app in your Google Cloud project, which takes about 13 minutes.
What do I need from Google Cloud?
A Google Cloud project where you can create a Chat app, plus a service-account key and an OAuth client. CatalEx does not connect without both.
Do I need a server for a Google Chat bot?
No. Google Chat runs through CatalEx Cloud, so you run no server and need no public address.