> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Send Google Chat Messages From AI Agents

> Let agents read and send Google Chat messages and manage spaces and members. Connect with your Google OAuth client, and the gateway injects the token.

## Overview

Buckle connects AI agents to Google Chat through Google's OAuth flow. Agents can read spaces and messages, send and edit messages, and manage spaces and members. The gateway injects the token into every request, so your agent never sees it.

Google Chat uses **your own Google OAuth client**, on Buckle Cloud and self-hosted alike. One client covers every Google app in Buckle, so if you've already set one up for another Google app, skip to step 2.

## What you will set up

* A Google OAuth client with the Google Chat API enabled
* A Google Chat connection authorized with your account
* Per-agent, per-tool access, with approval for sending

## Connect Google Chat

**1. Set up your Google client**

Follow the [Google setup guide](/docs/integrations/google.md) once. Enable the **Google Chat API** in your Google Cloud project as part of it.

**2. Connect**

In the Buckle dashboard, open **Settings** > **Apps** > **Google Chat** and click **Connect Google Chat**. Pick your Google account and click **Allow**.

![Buckle connect window for Google Chat showing Configuration required, the setup guide link, and the Configure credentials button.](https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/google-chat/buckle-connect-google-chat.png?fit=max\&auto=format\&n=hJP3XqgFsBDnXHKy\&q=85\&s=ae242338dc8b605ea491ed132a84f94c)

The Google Chat connect window in Buckle before a Google client is set up.

## What agents can do

| Area | What agents can do |
| - | - |
| **Spaces** | List and read spaces. Create, update, and delete spaces |
| **Messages** | List and read messages. Send, update, and delete messages |
| **Members** | List and read members. Add and remove members |

## Controlling access

[Grant](/docs/guides/agent-access.md) the connection to each agent that needs it, and choose per tool what runs freely, what needs approval, and what's blocked. Put **Send message** and **Delete space** behind approval. Organization [rules](/docs/guides/rules.md) add guardrails on top. A blocked request never reaches Google Chat.

To disconnect, remove the connection in **Settings** > **Apps** > **Google Chat**, then revoke Buckle at [myaccount.google.com/permissions](https://myaccount.google.com/permissions).

## FAQ

> [accordion] Do I need my own Google client for Google Chat?
>
> Yes, on Cloud and self-hosted. Follow the [Google setup guide](/docs/integrations/google.md) once and enable the **Google Chat API**.

> [accordion] Does the agent see my Google token?
>
> No. The token stays in Buckle, and the gateway adds it at the proxy. See [How it works](/docs/how-it-works.md).

> [accordion] Can I approve messages before they're sent?
>
> Yes. Put **Send message** behind approval when you [grant](/docs/guides/agent-access.md) the connection.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.