Google Chat MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Google Chat MCP or direct API to send space messages, list conversations, read thread updates, and manage members through natural language.

Google Chat logoGoogle Chat
Oauth2

Google Chat is Google Workspace's messaging and collaboration service for teams. It keeps conversations, spaces, files, and work updates in one shared place.

45 Tools

Try Google Chat now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Google Chat
Try asking
TOOLS

Supported Tools

Every Google Chat action and event your agent gets out of the box.

Complete Space Import

Completes the import process for an import-mode Google Chat space and makes it visible to users.

Create Custom Emoji

Creates a custom emoji in Google Chat for use within an organization.

Create Space Member

Creates a membership for a user, Chat app, or Google Group in a space.

Create Message

Creates a message in a Google Chat space.

Create Reaction

Creates an emoji reaction on a Google Chat message.

Create section

Creates a custom section in Google Chat for organizing conversations in the navigation panel.

Create Space

Creates a named space or group chat in Google Chat.

Delete Custom Emoji

Deletes a custom emoji from Google Chat.

Delete Member from Space

Removes a user, Google Group, or app from a space.

Delete Message

Deletes a message from a Google Chat space.

Delete Reaction

Deletes a reaction to a message.

Delete section

Deletes a custom section from Google Chat by its ID.

Delete space

Deletes a named space from Google Chat.

Download Media

Downloads the bytes of a Google Chat message attachment via the media API.

Find Direct Message

Returns the existing direct message space with the specified user.

Find Group Chats

Finds all group chat spaces that contain exactly the calling user and the specified users.

Get Attachment

Gets the metadata of a Google Chat message attachment.

Get Custom Emoji

Returns details about a custom emoji in Google Chat.

Get Chat Space Member

Returns details about a membership in a space.

Get Message

Returns details about a specific message in a Google Chat space.

Get Space

Returns details about a specific Google Chat space including configuration, membership count, and access settings.

Get Space Event

Returns an event from a Google Chat space.

Get Space Notification Setting

Gets the notification settings for a user in a specific space.

Get space read state

Returns details about a user's read state within a space.

Get thread read state

Returns details about a user's read state within a thread.

List custom emojis

Lists custom emojis visible to the authenticated user in Google Chat.

List Space Members

Lists memberships in a space.

List Messages

Lists messages in a space that the authenticated user is a member of.

List reactions on a message

Lists all reactions on a specific message in a Google Chat space.

List Section Items

Lists all items (such as spaces) within a specified section of a user's Google Chat.

List Sections

Lists all sections available to the authenticated user in Google Chat.

List Space Events

Lists events from a Google Chat space.

List Spaces

Lists spaces the authenticated user is a member of in Google Chat.

Move Section Item

Moves a space from one section to another in Google Chat.

Position Section in Sidebar

Changes the sort order of a section in the Google Chat sidebar.

Replace Message (Full)

Replaces an existing message in a Google Chat space using full replacement.

Search Spaces

Searches for spaces across a Google Workspace organization using administrator privileges.

Setup Space

Creates a space and adds specified users and groups to it.

Update Member

Updates a membership in a Google Chat space, such as changing a member's role between member and manager.

Update Message

Updates a message in a Google Chat space, modifying its text, cards, or other properties.

Update section

Updates a section's display name in Google Chat.

Update Space

Updates a Google Chat space's configuration including display name, description, guidelines, history settings, access settings, and permission settings.

Update Space Notification Setting

Updates the notification settings for a user in a space.

Update Space Read State

Updates a user's read state within a space, used to mark messages as read or unread.

Upload Media Attachment

Uploads a file as an attachment to a Google Chat space using the multipart media upload endpoint.

SETUP GUIDE

Connect Google Chat MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["google_chat"],
  mcp: true,
});
Create a session scoped to Google Chat and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List all Google Chat spaces I can access and summarize their display names.",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Google Chat request
SETUP GUIDE

Connect Google Chat API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["google_chat"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Google Chat
3

Run Google Chat tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List all Google Chat spaces I can access and summarize their display names." }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Google Chat tool calls through the session, and print the final answer

Why Use Composio?

AI Native Google Chat Integration

  • Supports both Google Chat MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable message, space, and thread actions
  • Rich coverage for reading conversations, posting updates, and querying Google Chat spaces

Managed Auth

  • Built-in OAuth handling with automatic token refresh and lifecycle management
  • Central place to manage, scope, and revoke Google Chat access
  • Per user and per environment credentials instead of hard-coded tokens in your agent code

Agent Optimized Design

  • Tools are tuned using real error and success rates, so Google Chat actions get more reliable over time
  • Comprehensive execution logs show which space, message, or thread your agent touched

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Google Chat
  • Scoped, least privilege access to spaces, messages, and memberships
  • Full audit trail of agent actions to support review, debugging, and compliance
FRAMEWORKS

Use Google Chat with any AI Agent Framework

Choose a Framework you want to connect Google Chat with

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Google Chat requires connections to go through your own OAuth app. You register it once with Google Chat, add its client ID and secret in the Composio dashboard, and from then on everyone connects by signing in to Google Chat as usual. Composio handles the rest of the flow and the token refresh.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Yes. Composio is SOC 2 Type II compliant and is built to keep your Google Chat connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

When you connect a Google Chat account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in Google Chat as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Exactly the ones Google Chat lists on its consent screen when you connect. Review that screen before approving. If you connect a work account, your Google Chat administrator may need to approve the app first, and you can revoke the access inside Google Chat whenever you want.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each Google Chat connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

Composio refreshes Google Chat tokens automatically, so day to day you do nothing. If you revoke access inside Google Chat, or Google Chat invalidates the session, the connection shows as expired in Composio and the agent stops acting on that account until you reconnect it, which is a single sign-in.

Composio's free plan includes 100,000 tool calls per month with no credit card, which covers most personal Google Chat use. Paid plans add higher limits and team features. Your Google Chat plan and its API limits still apply as usual.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple Google Chat accounts).

With Composio, you connect Google Chat once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

Start with Google Chat.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Google Chat tool your agent needs.Free to start.

Start building