Skip to directory

About Google Chat MCP

Google Workspace remote MCP server for Google Chat. This service is in Google's Developer Preview.

Connection and setup
Hosting
Google-managed remote
Transport
Streamable HTTP
Endpoint
https://chatmcp.googleapis.com/mcp/v1
Authentication
OAuth 2.0. Configure the consent screen and an OAuth client marked “Use this client for an AI-powered agent”; grant only the listed product scopes and sign in with the Google account that should be accessible.

Requirements

  • Membership in the Google Workspace Developer Preview Program.
  • A Google Cloud project, with the relevant Workspace API and its MCP service enabled.
  • A supported remote MCP client and a Google account with access to the target Workspace data.
  • OAuth 2.0 consent configuration with these scopes: https://www.googleapis.com/auth/chat.spaces.readonly, https://www.googleapis.com/auth/chat.memberships.readonly, https://www.googleapis.com/auth/chat.messages.readonly, https://www.googleapis.com/auth/chat.messages.create, https://www.googleapis.com/auth/chat.users.readstate.

Setup steps

  1. Join the Google Workspace Developer Preview Program and select/create a Google Cloud project.
  2. Enable Google Chat API and the matching MCP service in that project.
  3. Configure Google Auth Platform consent and add the scopes shown in Requirements.
  4. Create an OAuth 2.0 client for an AI agent; use the redirect URI required by your MCP client.
  5. Add this server URL to the client: https://chatmcp.googleapis.com/mcp/v1
  6. Authenticate with the intended Google account, grant the requested scopes, refresh the tool list, and verify the listed operations.
Tools 9

Nine tools search/read Chat data, change read state, list memberships, and get/update notification settings. send_message posts; notification update alters mute/frequency. Treat messages as private and confirm sends.

  • search_conversations

    Officially listed search_conversations tool.

    01
  • list_messages

    Officially listed list_messages tool.

    02
  • search_messages

    Officially listed search_messages tool.

    03
  • send_message

    Officially listed send_message tool.

    04
  • mark_as_read

    Officially listed mark_as_read tool.

    05
  • mark_as_unread

    Officially listed mark_as_unread tool.

    06
  • list_memberships

    Officially listed list_memberships tool.

    07
  • get_notification_settings

    Officially listed get_notification_settings tool.

    08
  • update_notification_settings

    Officially listed update_notification_settings tool.

    09
Limitations and notes
  • Developer Preview
Original sources

Documentation checked 2026-10-28. Connection has not been runtime tested.