Google Chat a MCP: espacios, mensajes, hilos y reacciones en cualquier agente de IA

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Google Chat, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Google Chat

Deja que tu IA trabaje en Google Chat en tu nombre: encuentra espacios, chats de grupo y mensajes directos, lee y busca mensajes e hilos, ve miembros, reacciones y archivos adjuntos, sigue los cambios de un espacio, publica mensajes y respuestas, edita tus mensajes y reacciona. Cuentas de Google Workspace, acceso OAuth; borrar mensajes y reacciones viene desactivado.

Configuración

La configuración lleva unos 15 minutos. Necesitas una cuenta de Google Workspace (Business, Enterprise o Education): el acceso de usuario de la Google Chat API no funciona con cuentas personales de Gmail.

1. Abre https://console.cloud.google.com, elige o crea un proyecto, ve a APIs & Services → Library y habilita la Google Chat API.
2. Configura la Chat app, que Google exige para las llamadas a la Chat API hechas en nombre de un usuario: abre APIs & Services → Enabled APIs → Google Chat API → Configuration (https://console.cloud.google.com/apis/api/chat.googleapis.com/hangouts-chat). Rellena App name (por ejemplo AnythingMCP), Avatar URL (cualquier enlace HTTPS a un PNG o JPEG cuadrado) y Description, deja desactivadas las Interactive features y haz clic en Save. Sin este paso, publicar falla con "Google Chat app not found".
3. Abre APIs & Services → OAuth consent screen y elige Internal (Google Workspace). Una app External con el estado de publicación Testing pierde su refresh token a los 7 días.
4. Abre APIs & Services → Credentials → Create credentials → OAuth client ID, elige el tipo de aplicación Web application y añade el redirect URI autorizado <your AnythingMCP URL>/api/mcp-oauth/callback, en AnythingMCP Cloud https://cloud.anythingmcp.com/api/mcp-oauth/callback.
5. Pega el client ID en GOOGLE_CLIENT_ID y el client secret en GOOGLE_CLIENT_SECRET, e instala el conector.
6. En la página del conector haz clic en Authorize with Provider e inicia sesión con la cuenta de Google Workspace con la que debe actuar la IA. El refresh token se guarda cifrado y los access tokens se renuevan solos.
7. Ejecuta google_chat_list_spaces: lista los espacios, chats de grupo y mensajes directos de la cuenta conectada.

Un solo cliente de Google para todos los conectores de Google: el mismo proyecto de Cloud y el mismo cliente OAuth pueden servir a todos los conectores de Google (Gmail, Calendar, Drive, Sheets, Docs, Chat y más). Habilita cada API en ese proyecto, reutiliza GOOGLE_CLIENT_ID y GOOGLE_CLIENT_SECRET y autoriza cada conector una vez; cada uno pide solo sus propios scopes.

En nombre de quién escribe: el conector lee, publica y edita como el usuario conectado, exactamente como si lo escribiera él, y solo ve los espacios de los que ese usuario es miembro. La IA debería confirmarlo contigo antes de publicar en tu nombre.

Scopes: chat.spaces.readonly (ver espacios), chat.messages (leer, publicar, editar y borrar tus mensajes y reacciones) y chat.memberships.readonly (ver miembros). Para una configuración de solo lectura cambia chat.messages por https://www.googleapis.com/auth/chat.messages.readonly en los ajustes OAuth del conector, vuelve a autorizar y desactiva google_chat_create_message, google_chat_reply_in_thread, google_chat_update_message y google_chat_add_reaction.

Qué lee: cada espacio, chat de grupo y mensaje directo del que eres miembro (google_chat_list_spaces, filtrado por spaceType SPACE, GROUP_CHAT o DIRECT_MESSAGE), espacios con nombre buscados por nombre (google_chat_search_spaces, por ejemplo display_name:"Marketing" AND space_type = "SPACE"), el mensaje directo existente con una persona (google_chat_find_direct_message) y los detalles y miembros de un espacio. Los mensajes de un espacio, del más antiguo o del más reciente con order_by create_time desc, acotados por fecha (create_time > "2026-10-01T00:00:00Z") o a un hilo. Una búsqueda por palabras clave en todos los espacios y mensajes directos, del más reciente al más antiguo, con condiciones como sender.name = "users/[email protected]", createTime >= "2026-10-01T00:00:00Z", annotations.user_mentions.user.name:me (mensajes que te mencionan), attachment:*, has_link() o is_unread(). Las reacciones a un mensaje, los adjuntos de un mensaje y el registro de cambios de un espacio de los últimos 28 días: mensajes nuevos, cambiados y borrados, reacciones, membresías y cambios del espacio (google_chat_list_space_events; el filtro debe nombrar al menos un tipo de evento, como google.workspace.chat.message.v1.created).

Qué escribe: publica un mensaje en un espacio, chat de grupo o mensaje directo (en un espacio con hilos abre un hilo nuevo), responde en un hilo existente indicado por el thread.name de un mensaje, sustituye el texto de tus propios mensajes (los demás los ven marcados como editados) y añade reacciones con emoji. Con request_id una publicación repetida no aparece dos veces.

Desactivadas al instalar: google_chat_delete_message y google_chat_delete_reaction. Un mensaje borrado no se puede recuperar, así que un administrador las activa cuando el equipo las necesita.

Formatos de datos: Chat nombra todo con rutas: un espacio es spaces/AAAAMpdlehY, un mensaje spaces/AAAAMpdlehY/messages/ZJ7sqN6qlYk.ZJ7sqN6qlYk, un hilo spaces/AAAAMpdlehY/threads/FHT5Rc21TfA, una persona users/123456789. Las herramientas reciben por separado space_id (lo que sigue a spaces/) y message_id (lo que sigue a /messages/), y thread_name y user completos. En los filtros y en google_chat_find_direct_message también sirve un correo, como users/[email protected]. Remitentes y miembros suelen volver sin nombre visible, así que la IA identifica a las personas por ID o correo. Las horas son RFC 3339 en UTC (2026-10-29T14:05:31.123Z). El contenido de las tarjetas queda fuera de las respuestas. El texto de los mensajes admite *negrita*, _cursiva_, ~tachado~, código en línea entre comillas invertidas, enlaces como <https://example.com|label> y menciones como <users/123456789> o <users/all>; un mensaje tiene como máximo 32.000 bytes. Los adjuntos subidos se descargan hasta 10 MB; los archivos de Google Drive (source DRIVE_FILE) se leen con el conector de Google Drive mediante driveDataRef.driveFileId.

Paginación y límites: las respuestas traen nextPageToken mientras haya más resultados; la IA vuelve a llamar a la misma herramienta con page_token. google_chat_list_messages devuelve por defecto 25 mensajes por página. Google Chat permite unas 3.000 lecturas por minuto y proyecto y alrededor de 1 mensaje por segundo y espacio; una llamada limitada responde 429 RESOURCE_EXHAUSTED: espera y reintenta. La búsqueda de mensajes omite los de Chat apps y los de espacios silenciados; google_chat_list_messages sí los lee.

Errores comunes: 401 significa que la autorización caducó o se revocó: vuelve a hacer clic en Authorize with Provider. 403 PERMISSION_DENIED significa que la Chat API no está habilitada, falta un scope, la cuenta no es de Google Workspace o no puedes hacer eso en ese espacio, como editar el mensaje de otra persona. 404 NOT_FOUND es un ID de espacio o mensaje incorrecto, un espacio del que no eres miembro o, al publicar, una Chat app que no se configuró en el paso 2. google_chat_find_direct_message responde 404 si nunca has tenido un mensaje directo con esa persona. 400 INVALID_ARGUMENT es un filtro que Google no acepta: revisa comillas, operadores y nombres de campo.

El conector no crea espacios, no añade ni quita miembros, no abre mensajes directos nuevos, no sube archivos, no envía tarjetas ni publica como bot de una Chat app, y no gestiona mensajes fijados ni el estado de lectura.

Requisitos previos: GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET

Instalar el conector localmente

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Abre http://localhost:3000/connectors/store, elige Google Chat e introduce las variables listadas en los Requisitos previos.

Herramientas disponibles

Ejemplos de prompts

• "¿De qué se habló esta semana en el espacio Marketing? Resume cada hilo en dos líneas."
• "Busca los mensajes sin leer de los últimos tres días en los que me mencionan."
• "Redacta una respuesta en el hilo sobre el presupuesto del cuarto trimestre y enséñamela antes de publicarla."
• "Envía un mensaje directo a [email protected] diciendo que la presentación está lista para revisar."
• "¿Qué archivos se compartieron en octubre en el espacio Producto?"

Siguientes pasos

• Conectar a Claude
• Conectar a ChatGPT