Google Chat su MCP: spazi, messaggi, thread e reazioni in qualsiasi agente AI

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Google Chat, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Google Chat

Fai lavorare la tua AI in Google Chat a tuo nome: trova spazi, chat di gruppo e messaggi diretti, leggi e cerca messaggi e thread, vedi membri, reazioni e allegati, segui cosa è cambiato in uno spazio, pubblica messaggi e risposte, modifica i tuoi messaggi e reagisci. Account Google Workspace, accesso OAuth; l'eliminazione di messaggi e reazioni è disattivata all'installazione.

Setup

La configurazione richiede circa 15 minuti. Ti serve un account Google Workspace (Business, Enterprise o Education): l'accesso utente della Google Chat API non funziona con gli account Gmail personali.

1. Apri https://console.cloud.google.com, scegli o crea un progetto, poi vai su APIs & Services → Library e attiva la Google Chat API.
2. Configura la Chat app, che Google richiede per le chiamate alla Chat API fatte per conto di un utente: apri APIs & Services → Enabled APIs → Google Chat API → Configuration (https://console.cloud.google.com/apis/api/chat.googleapis.com/hangouts-chat). Compila App name (ad esempio AnythingMCP), Avatar URL (un qualsiasi link HTTPS a un PNG o JPEG quadrato) e Description, lascia spente le Interactive features e clicca Save. Senza questo passo la pubblicazione fallisce con "Google Chat app not found".
3. Apri APIs & Services → OAuth consent screen e scegli Internal (Google Workspace). Un'app External con stato di pubblicazione Testing perde il refresh token dopo 7 giorni.
4. Apri APIs & Services → Credentials → Create credentials → OAuth client ID, scegli il tipo di applicazione Web application e aggiungi il redirect URI autorizzato <your AnythingMCP URL>/api/mcp-oauth/callback, su AnythingMCP Cloud https://cloud.anythingmcp.com/api/mcp-oauth/callback.
5. Incolla il client ID in GOOGLE_CLIENT_ID e il client secret in GOOGLE_CLIENT_SECRET, poi installa il connettore.
6. Nella pagina del connettore clicca Authorize with Provider e accedi con l'account Google Workspace con cui l'AI deve agire. Il refresh token viene salvato cifrato e gli access token si rinnovano da soli.
7. Esegui google_chat_list_spaces: elenca gli spazi, le chat di gruppo e i messaggi diretti dell'account collegato.

Un solo client Google per tutti i connettori Google: lo stesso progetto Cloud e lo stesso client OAuth possono servire ogni connettore Google (Gmail, Calendar, Drive, Sheets, Docs, Chat e altri). Attiva ogni API in quel progetto, riusa GOOGLE_CLIENT_ID e GOOGLE_CLIENT_SECRET e autorizza ogni connettore una volta; ognuno chiede solo i propri scope.

A nome di chi scrive: il connettore legge, pubblica e modifica come l'utente collegato, esattamente come se scrivesse lui, e vede solo gli spazi di cui quell'utente fa parte. L'AI dovrebbe chiederti conferma prima di pubblicare a tuo nome.

Scope: chat.spaces.readonly (vedere gli spazi), chat.messages (leggere, pubblicare, modificare ed eliminare i tuoi messaggi e reazioni) e chat.memberships.readonly (vedere i membri). Per una configurazione in sola lettura cambia chat.messages in https://www.googleapis.com/auth/chat.messages.readonly nelle impostazioni OAuth del connettore, autorizza di nuovo e disattiva google_chat_create_message, google_chat_reply_in_thread, google_chat_update_message e google_chat_add_reaction.

Cosa legge: ogni spazio, chat di gruppo e messaggio diretto di cui fai parte (google_chat_list_spaces, filtrato per spaceType SPACE, GROUP_CHAT o DIRECT_MESSAGE), gli spazi con nome cercati per nome (google_chat_search_spaces, ad esempio display_name:"Marketing" AND space_type = "SPACE"), il messaggio diretto già esistente con una persona (google_chat_find_direct_message), i dettagli e i membri di uno spazio. I messaggi di uno spazio, dal più vecchio o dal più recente con order_by create_time desc, filtrati per data (create_time > "2026-10-01T00:00:00Z") o su un singolo thread. Una ricerca per parole chiave in tutti gli spazi e messaggi diretti, dal più recente, con condizioni come sender.name = "users/[email protected]", createTime >= "2026-10-01T00:00:00Z", annotations.user_mentions.user.name:me (messaggi che ti menzionano), attachment:*, has_link() o is_unread(). Le reazioni a un messaggio, gli allegati di un messaggio e il registro delle modifiche di uno spazio degli ultimi 28 giorni: messaggi nuovi, modificati ed eliminati, reazioni, iscrizioni e modifiche allo spazio (google_chat_list_space_events, il filtro deve indicare almeno un tipo di evento come google.workspace.chat.message.v1.created).

Cosa scrive: pubblica un messaggio in uno spazio, una chat di gruppo o un messaggio diretto (in uno spazio con thread ne apre uno nuovo), risponde in un thread esistente indicato dal thread.name di un messaggio, sostituisce il testo dei tuoi messaggi (gli altri li vedono segnati come modificati) e aggiunge reazioni emoji. Con request_id un post ripetuto non compare due volte.

Disattivati all'installazione: google_chat_delete_message e google_chat_delete_reaction. Un messaggio eliminato non si può recuperare, quindi un admin li attiva quando il team ne ha bisogno.

Formati dei dati: Chat identifica tutto con percorsi: uno spazio è spaces/AAAAMpdlehY, un messaggio spaces/AAAAMpdlehY/messages/ZJ7sqN6qlYk.ZJ7sqN6qlYk, un thread spaces/AAAAMpdlehY/threads/FHT5Rc21TfA, una persona users/123456789. I tool prendono separatamente space_id (la parte dopo spaces/) e message_id (la parte dopo /messages/), mentre thread_name e user vanno per intero. Nei filtri e in google_chat_find_direct_message funziona anche un'email, come users/[email protected]. Mittenti e membri tornano di solito senza nome visualizzato, quindi l'AI riconosce le persone da ID o email. Gli orari sono RFC 3339 in UTC (2026-10-29T14:05:31.123Z). Il contenuto delle card resta fuori dalle risposte. Il testo dei messaggi supporta *grassetto*, _corsivo_, ~barrato~, codice inline tra backtick, link come <https://example.com|label> e menzioni come <users/123456789> o <users/all>; un messaggio contiene al massimo 32.000 byte. Gli allegati caricati si scaricano fino a 10 MB; i file di Google Drive (source DRIVE_FILE) si leggono con il connettore Google Drive tramite driveDataRef.driveFileId.

Paginazione e limiti: le risposte contengono nextPageToken finché ci sono altri risultati; l'AI richiama lo stesso tool con page_token. google_chat_list_messages restituisce di default 25 messaggi per pagina. Google Chat consente circa 3.000 letture al minuto per progetto e circa 1 messaggio al secondo per spazio; una chiamata limitata risponde 429 RESOURCE_EXHAUSTED: aspetta e riprova. La ricerca nei messaggi salta quelli delle Chat app e degli spazi silenziati; google_chat_list_messages li legge comunque.

Errori comuni: 401 significa che l'autorizzazione è scaduta o è stata revocata: clicca di nuovo Authorize with Provider. 403 PERMISSION_DENIED significa che la Chat API non è attiva, manca uno scope, l'account non è Google Workspace oppure non puoi farlo in quello spazio, ad esempio modificare il messaggio di un altro. 404 NOT_FOUND è un ID di spazio o messaggio sbagliato, uno spazio di cui non fai parte oppure, quando pubblichi, una Chat app non configurata al passo 2. google_chat_find_direct_message risponde 404 se con quella persona non hai mai avuto un messaggio diretto. 400 INVALID_ARGUMENT è un filtro che Google non accetta: controlla virgolette, operatori e nomi dei campi.

Il connettore non crea spazi, non aggiunge né rimuove membri, non apre nuovi messaggi diretti, non carica file, non invia card, non pubblica come bot di una Chat app e non gestisce messaggi fissati o stato di lettura.

Prerequisiti: GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET

Installazione locale del connettore

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

Apri http://localhost:3000/connectors/store, scegli Google Chat e inserisci le variabili elencate nei Prerequisiti.

Tool disponibili

Esempi di prompt

• "Di cosa si è parlato questa settimana nello spazio Marketing? Riassumi ogni thread in due righe."
• "Trova i messaggi non letti degli ultimi tre giorni in cui vengo menzionato."
• "Scrivi una bozza di risposta nel thread sul budget del Q4 e fammela vedere prima di pubblicarla."
• "Manda un messaggio diretto a [email protected] per dirle che la presentazione è pronta per la revisione."
• "Quali file sono stati condivisi a ottobre nello spazio Prodotto?"

Prossimi passi

• Collegare a Claude
• Collegare a ChatGPT