google-chat-mcp

Servidor MCP para Google Chat. Permite a Claude (Code / Desktop) o a cualquier cliente MCP listar tus espacios, leer y buscar mensajes, obtener hilos y miembros, y — opcionalmente — enviar mensajes como tú.

De solo lectura por defecto. Se ejecuta localmente sobre stdio. El token de actualización se almacena con permisos 0600 en ~/.google-chat-mcp/.

Herramientas

Los nombres de los remitentes provienen del directorio de People API (directory.readonly). Si esa API está deshabilitada o el usuario es externo, obtienes users/<id> en su lugar; todo lo demás sigue funcionando.

Related MCP server: google-mcp

Configuración

Requiere una cuenta de Google Workspace. Las cuentas de consumidor @gmail.com no pueden llamar a la API de Chat (403).

1. Proyecto de Google Cloud (una vez, ~10 min)

1. console.cloud.google.com → crea/selecciona un proyecto.

2. APIs y Servicios → Biblioteca → habilita Google Chat API y People API.

3. Pestaña Google Chat API → Configuración → completa Nombre de la aplicación, URL del avatar, Descripción; funciones interactivas desactivadas; visibilidad para tu dominio. Guarda.

   Advertencia: la API de Chat rechaza todas las llamadas OAuth con 403 hasta que se guarde este formulario, incluso para la autenticación de usuario de solo lectura.

4. Pantalla de consentimiento de OAuth → Interna → añade los ámbitos:

   • https://www.googleapis.com/auth/chat.spaces.readonly

   • https://www.googleapis.com/auth/chat.messages.readonly

   • https://www.googleapis.com/auth/chat.memberships.readonly

   • https://www.googleapis.com/auth/directory.readonly

   • https://www.googleapis.com/auth/chat.messages.create (solo si quieres send_message)

5. Credenciales → Crear credenciales → ID de cliente OAuth → Aplicación de escritorio → descarga el JSON. Mantenlo fuera de cualquier repositorio.

2. Iniciar sesión

export GOOGLE_CHAT_CLIENT_SECRET_PATH=/path/to/client_secret.json
npx google-chat-mcp login        # browser opens → sign in with your Workspace account
npx google-chat-mcp whoami       # sanity check

3. Regístrate con Claude Code

claude mcp add google-chat \
  -e GOOGLE_CHAT_CLIENT_SECRET_PATH=/path/to/client_secret.json \
  -- npx -y google-chat-mcp

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "google-chat": {
      "command": "npx",
      "args": ["-y", "google-chat-mcp"],
      "env": { "GOOGLE_CHAT_CLIENT_SECRET_PATH": "/path/to/client_secret.json" }
    }
  }
}

Entorno

Notas de cuota

API de Chat: ~60 solicitudes/min/usuario. Los espacios y las listas de miembros se almacenan en caché durante 5 minutos en el proceso; los nombres de usuario resueltos se almacenan en caché en disco en ~/.google-chat-mcp/users.json. search_messages es el costoso: delimítalo con spaces y since.

Desarrollo

pnpm install
pnpm dev login
pnpm typecheck && pnpm lint && pnpm build

Node ≥ 22. TypeScript estricto, ESM, compilación con tsup.

Licencia

MIT