Google Chat MCP server

Connect Google Chat to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Google Chat MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the list space events tool in Google Chat
  • Use the manage reaction tool in Google Chat
  • Use the upload attachment tool in Google Chat
  • Use the send message tool in Google Chat
  • Use the download attachment tool in Google Chat
  • Use the get attachment tool in Google Chat

How teams use Google Chat with agents

Google Chat is where Workspace teams talk. The integration lets an agent post updates to spaces, search conversations for context and manage spaces and members, either as a person or as a Chat app.

Post updates

Send deploy notes, incident updates or daily summaries into the right space.

Find past decisions

Search messages across spaces to find where something was agreed and link back to it.

Space setup

Create a project space, add the right members and share files as attachments.

Direct messages

Find the direct message with a colleague and send a follow-up on their behalf.

Tools to start with

  • Search Messages: Full-text search across the spaces the account can read.
  • Send Message: Posts to a space or thread.
  • Search Spaces (Admin): Admin-wide view of spaces in the organisation.

Sign-in and permissions

Chat offers Google OAuth, which acts as the signed-in person, and a Chat app service account, which posts as the app. Admin space search needs a Workspace administrator. Chat app access also has to be configured in your Google Cloud project.

Sign-in options on Metorial: Google OAuth, Google Chat App Service Account.

Supported Tools

list_space_events

List Space Events

List events from a Google Chat space, or provide eventId to retrieve one specific space event.

manage_reaction

Manage Reaction

Create Unicode emoji reactions, or list and delete emoji reactions on Google Chat messages.

upload_attachment

Upload Attachment

Upload base64-encoded file bytes to a Google Chat space and return the attachment data reference needed to include it in a message.

send_message

Send Message

Send a Markdown-formatted text message to a Google Chat conversation. Optionally reply to an existing thread by resource name or start or reply to an application-owned thread using a thread key.

download_attachment

Download Attachment

Download an uploaded Google Chat attachment as a downloadable file.

get_attachment

Get Attachment

Get metadata for a Google Chat message attachment. File bytes are retrieved separately with download_attachment.

manage_space

Manage Space

Create, set up, get, update, or delete a Google Chat space. Setup can create a named space, group chat, or direct message with initial members.

find_direct_message

Find Direct Message

Find the existing Google Chat direct-message space between the specified user and the authenticated user or calling Chat app.

manage_message

Manage Message

Get, update, or delete a Google Chat message. Updates use messages.patch with an explicit text update mask, so only the plain text body can be changed.

search_conversations

Search Conversations

List Google Chat conversations the caller can access, optionally filtering the API page by conversation type and matching display names or resource names case-insensitively.

list_messages

List Messages

List messages from a Google Chat conversation with optional thread and time filters, reverse-chronological ordering, and page-token pagination.

search_messages

Search Messages

Search messages across Google Chat using the messages.search API, including keyword and provider-supported message filters. When the search API is unavailable for the account or project (HTTP 403/404), the tool falls back to spaces.messages.list on one conversation with client-side keyword matching.

manage_section

Manage Section

Create, rename, reorder, or delete custom sections in the signed-in user's Google Chat sidebar.

list_sections

List Sections

List the signed-in user's Google Chat sidebar sections, including custom sections and the default Direct messages, Spaces, and Apps sections.

update_space_read_state

Update Space Read State

Mark a Google Chat space as read or unread for the signed-in user by moving their last-read time. Set markAsRead to true to mark everything read, or pass lastReadTime to mark later messages unread.

search_spaces_admin

Search Spaces (Admin)

Search every named Google Chat space in the organization with Google Workspace administrator privileges, using the Chat admin space search syntax. Returns spaces the administrator isn't a member of.

get_space_notification_setting

Get Space Notification Setting

Get the signed-in user's notification and mute settings for a Google Chat space.

list_custom_emojis

List Custom Emojis

List the custom emoji visible to the signed-in user in their Google Workspace organization's Google Chat.

get_space_read_state

Get Space Read State

Get the signed-in user's read position in a Google Chat space: the last time they read the space's top-level conversation. Messages created after lastReadTime are unread.

update_space_notification_setting

Update Space Notification Setting

Change the signed-in user's notification level or mute state for a Google Chat space.

manage_custom_emoji

Manage Custom Emoji

Create a Google Chat custom emoji from an image, or delete one, in the signed-in user's Google Workspace organization.

get_thread_read_state

Get Thread Read State

Get the signed-in user's read position in a Google Chat thread: the last time they read replies in that thread. Replies created after lastReadTime are unread.

get_custom_emoji

Get Custom Emoji

Get one Google Chat custom emoji by resource name or :shortcode:, including a temporary image URL.

list_section_items

List Section Items

List the conversations (spaces) in one of the signed-in user's Google Chat sidebar sections, or find which section holds a given space.

move_section_item

Move Section Item

Move a conversation (section item) to a different section in the signed-in user's Google Chat sidebar.

list_members

List Members

List the members of a Google Chat space, with optional role and member-type filters, Google Group and invited memberships, and page-token pagination.

manage_membership

Manage Membership

Get, add, update the role of, or remove a member of a Google Chat space. Members can be users (by ID or email) or, in named spaces, Google Groups.

Connect Google Chat to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Google Chat in Metorial. In your Metorial portal, enable the Google Chat MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Google Chat tools.

Run Google Chat through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Google Chat and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Google Chat tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Google Chat

Slack

Slack: connect with bot OAuth or user OAuth to work with messages, conversations, search, files, Canvases, Lists, profiles, reactions, reminders, and workspace productivity settings.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Gmail

Send, read, and search email messages with support for recipients, attachments, and HTML content. Create, update, and send drafts. Manage conversation threads and organize messages with labels. Search mailboxes using Gmail query syntax (from, to, subject, date, attachment filters). Manage filters and vacation responders, update the primary address's display name and signature, and view send-as aliases, forwarding addresses, and auto-forwarding status. Import and insert messages for migration.

Google Drive

Upload, download, create, copy, move, rename, trash, and permanently delete files and folders in Google Drive. Search for files using complex queries filtering by name, MIME type, owner, modification date, labels, and other metadata. Share files and folders with specific users, groups, or domains with role-based permissions (owner, writer, commenter, reader). Manage shared drives and their members. Export Google Workspace files (Docs, Sheets, Slides) to standard formats like PDF, DOCX, and XLSX. Track file revision history and restore earlier versions. Create, read, update, and delete threaded comments and replies on files. Read label definitions and search files by label. Browse the Drive apps installed for your account. Store app-specific data in a hidden per-user folder.

Confluence

Create, read, update, and delete pages, blog posts, comments, and attachments in Confluence spaces. Manage spaces, permissions, labels, and content restrictions. Search content using Confluence Query Language (CQL). Upload and download file attachments with versioning. Manage users, groups, and group memberships. Create and manage whiteboards, databases, folders, and templates. View and update inline tasks. Access audit logs.

Technical notes for Google Chat

Connect Google Chat for authenticated space, membership, message, reaction, attachment, space-event, read-state, notification-setting, sidebar-section, custom-emoji, and admin space search workflows.

Frequently asked questions

Common questions about connecting Google Chat to AI agents with Metorial.

  1. How many tools does the Google Chat MCP server have?
    The Google Chat MCP server exposes 27 tools, including List Space Events, Manage Reaction, Upload Attachment. Each one is governed and traced through Metorial.
  2. Google Chat exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Google Chat MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Google Chat and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Google Chat MCP server yourself or use the hosted gateway.

Connect Google Chat to production AI agents

See how Metorial gives your team governed access to Google Chat, with tracing and security controls built in.