Google Chat MCP Server

by chy168

Integrations

  • Provides tools for accessing and interacting with Google Chat spaces and messages, including listing available spaces and retrieving messages with date filtering.

  • Utilizes Google Cloud authentication for OAuth2 credentials required to access Google Chat API.

Introducción

Este proyecto proporciona una integración de Google Chat para servidores MCP (Protocolo de Control de Modelos) escritos en Python con FastMCP. Permite acceder e interactuar con espacios y mensajes de Google Chat mediante herramientas MCP.

Estructura

El proyecto consta de dos componentes principales:

  1. Servidor MCP con herramientas de Google Chat : proporciona herramientas para interactuar con Google Chat a través del Protocolo de control de modelos.
    • Escrito por FastMCP
    • server.py : Implementación del servidor MCP principal con herramientas de Google Chat
    • google_chat.py : Integración de la API de Google Chat y gestión de la autenticación
  2. Servidor de autenticación : componente independiente para la autenticación de cuentas de Google
    • Escrito por FastAPI
    • Maneja el flujo OAuth2 con Google
    • Almacena y administra tokens de acceso
    • Se puede ejecutar de forma independiente o como parte del servidor MCP
    • server_auth.py : Implementación del servidor de autenticación

El flujo de autenticación te permite obtener y actualizar los tokens de la API de Google, que luego utilizan las herramientas de MCP para acceder a los datos de Google Chat (tus espacios y mensajes).

Características

  • Autenticación OAuth2 con la API de Google Chat
  • Lista de espacios de chat de Google disponibles
  • Recuperar mensajes de espacios específicos con filtrado de fechas
  • Servidor de autenticación local para una fácil configuración

Requisitos

  • Python 3.8+
  • Proyecto de Google Cloud con API de chat habilitada
  • Credenciales OAuth2 de Google Cloud Console

¿Cómo utilizarlo?

Preparar el inicio de sesión de Google OAuth

  1. Clonar este proyecto
    git clone https://github.com/chy168/google-chat-mcp-server.git cd google-chat-mcp-server
  2. Preparar un proyecto de Google Cloud (GCP)
  3. Google Cloud Console ( https://console.cloud.google.com/auth/overview?project=\ <SU_NOMBRE_DE_PROYECTO>)
  4. Plataforma de autenticación de Google > Clientes > (+) Crear cliente > Referencia de la aplicación web: https://developers.google.com/identity/protocols/oauth2/?hl=es Orígenes de JavaScript autorizados: http://localhost:8000 URI de redireccionamiento autorizados: http://localhost:8000/auth/callback
  5. Después de crear un cliente OAuth 2.0, descargue los secretos del cliente como archivo .json . Guárdelos como credentials.json en el nivel superior del proyecto.

Ejecute el servidor de autenticación y obtenga su token de acceso de Google (inicie sesión solo en Google, todavía no en el servidor MCP)

python server.py -local-auth --port 8000
  • Abra el navegador en http://localhost:8000/auth
  • ¡Inicia sesión!
  • Después de iniciar sesión, su token de acceso se guardará como token.json

Configuración de MCP (mcp.json)

{ "mcpServers": { "google_chat": { "command": "uv", "args": [ "--directory", "<YOUR_REPO_PATH>/google-chat-mcp-server", "run", "server.py", "--token-path", "<YOUR_REPO_PATH>/google-chat-mcp-server/token.json" ] } }

Herramientas

El servidor MCP proporciona las siguientes herramientas:

Herramientas de chat de Google

  • get_chat_spaces() - Enumera todos los espacios de Google Chat a los que el bot tiene acceso
  • get_space_messages(space_name: str, start_date: str, end_date: str = None) - Lista de mensajes de un espacio específico de Google Chat con filtrado de tiempo opcional

Desarrollo y depuración

fastmcp dev server.py --with-editable .
-
security - not tested
F
license - not found
-
quality - not tested

Proporciona herramientas MCP (Protocolo de control de modelos) para acceder e interactuar con espacios y mensajes de Google Chat a través de la autenticación OAuth2.

  1. Structure
    1. Features
      1. Requirements
        1. How to use?
          1. Prepare Google Oauth Login
          2. Run Auth server and get your Google access token (login google only, not MCP server yet)
          3. MCP Configuration (mcp.json)
          4. Tools
          5. Development and Debug

        Related MCP Servers

        • -
          security
          F
          license
          -
          quality
          A specialized Model Context Protocol (MCP) server that integrates Google services (Gmail, Calendar, etc.) into your AI workflows. This server enables seamless access to Google services through MCP, allowing AI agents to interact with Gmail, Google Calendar, and other Google services.
          Last updated -
          10
          3
          TypeScript
        • -
          security
          F
          license
          -
          quality
          This server provides a standardized framework using the Model Context Protocol (MCP) to seamlessly integrate and manage diverse tools, enabling features like Twitter automation, cryptocurrency updates, and ElizaOS interaction.
          Last updated -
          2
          Python
        • -
          security
          A
          license
          -
          quality
          A secure MCP (Model Context Protocol) server hosted on Google Cloud Run that enables team collaboration by providing authenticated access via Google Cloud IAM, allowing teams to share custom MCP servers over the internet before official MCP authentication is implemented.
          Last updated -
          16
          TypeScript
          MIT License
        • -
          security
          A
          license
          -
          quality
          A Model Context Protocol server that provides seamless integration with Google Workspace, allowing operations with Google Drive, Docs, and Sheets through secure OAuth2 authentication.
          Last updated -
          Python
          MIT License
          • Linux
          • Apple

        View all related MCP servers

        ID: 8bcrxn62bu