# Put your AI agent in Google Chat

Source: https://catalex.co/google-chat-ai-agent/ · Updated 2026-11-19

CatalEx connects your Claude Code or Codex agent to a Google Chat app in a Google Cloud project you control. People mention the app in a space or send it a direct message, and the agent replies in Google Chat. Setup takes about 13 minutes and needs no server.

## 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.

## 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.

## How to add your agent to Google Chat

1. **Install CatalEx**: Download [CatalEx for Mac](https://downloads.catalex.co/latest/CatalEx-arm64.dmg) and sign in with Google.
2. **Add your agent**: Point CatalEx at your agent's folder and check it answers. [Add an agent](https://docs.catalex.co/agents/add-an-agent).
3. **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](https://docs.catalex.co/channels/google-chat).
4. **Message it**: Mention the app in a space or send it a direct message.

## 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.

## Get CatalEx

- Download for Mac (Apple silicon): https://downloads.catalex.co/latest/CatalEx-arm64.dmg
- Docs: https://docs.catalex.co/
