Come collegare Google Forms a Gemini via MCP

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

Google Forms + Gemini

Fai creare e leggere Google Forms alla tua AI: crea moduli e quiz, aggiungi domande di testo, a scelta, a scala, di data e di altri tipi, pubblica o chiudi un modulo e leggi le risposte. Account Google personali e Google Workspace.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET

Step 1 — Ottieni le credenziali

1. Apri console.cloud.google.com, scegli o crea un progetto, poi vai su APIs & Services → Library e abilita la Google Forms API.
2. Apri APIs & Services → OAuth consent screen. Scegli Internal se usi Google Workspace (la via più semplice), altrimenti External. Con External imposta lo stato di pubblicazione su In production: finché l'app è in Testing, Google revoca i refresh token dopo 7 giorni e il connettore smette di funzionare ogni settimana. Per il tuo account puoi semplicemente proseguire oltre l'avviso "unverified app".
3. Apri APIs & Services → Credentials → Create credentials → OAuth client ID, scegli il tipo di applicazione Web application e aggiungi l'URI di reindirizzamento autorizzato https://cloud.anythingmcp.com/api/mcp-oauth/callback. Se ospiti AnythingMCP in proprio, inserisci invece https://tuo-host-anythingmcp/api/mcp-oauth/callback.
4. Inserisci il client ID in GOOGLE_CLIENT_ID e il client secret in GOOGLE_CLIENT_SECRET, poi installa il connettore.
5. Nella pagina del connettore clicca su Authorize with Provider e accedi con l'account Google di cui l'AI deve usare i moduli. Il refresh token viene salvato cifrato e gli access token si rinnovano automaticamente.

Un solo client Google per tutti i connettori Google: lo stesso progetto Cloud e lo stesso client OAuth servono tutti i connettori Google: Gmail, Google Calendar, Google Drive, Google Sheets, Google Docs, Google Slides, Google Forms, Google Contacts, Google Meet, Google Tasks, Search Console, Analytics e Ads. Abilita ogni API in quel progetto, riusa lo stesso client ID e lo stesso secret e autorizza ogni connettore una volta. Ognuno chiede solo i propri permessi.

Trovare un modulo: incolla nella chat il link di modifica del modulo; il suo id è la stringa lunga in https://docs.google.com/forms/d/<id>/edit. Il link che ricevono i partecipanti (/forms/d/e/.../viewform) contiene un id diverso, che qui non funziona. Per trovare i moduli per nome, aggiungi anche il connettore Google Drive. Il connettore lavora sui moduli di cui il tuo account è proprietario o che può modificare; i moduli che puoi solo compilare non si possono leggere.

Costruire un modulo: quando si crea un modulo, Google accetta solo il titolo. Poi l'AI aggiunge le domande in ordine: risposta breve e paragrafo, scelta multipla, caselle di controllo ed elenchi a discesa, scale lineari, valutazioni, date e orari, griglie, sezioni, blocchi di testo, immagini, video di YouTube e domande di quiz con punteggio. Imposta la descrizione in un passaggio separato e può trasformare il modulo in un quiz o raccogliere gli indirizzi email dei partecipanti.

I nuovi moduli nascono non pubblicati: un modulo creato tramite l'API non accetta risposte finché non viene pubblicato (è il comportamento predefinito di Google dal 30 giugno 2026). L'AI lo pubblica e lo apre alle risposte con google_forms_set_publish_settings, poi ti dà il link da condividere. Con lo stesso tool chiude un modulo a nuove risposte; quelle già ricevute restano.

Leggere le risposte: l'AI legge il modulo una volta per abbinare ogni risposta alla sua domanda, e può elencare solo le risposte inviate da un certo momento in poi. Le risposte a scelta arrivano come testo dell'opzione, i file caricati come id di file Google Drive. Per i moduli molto grandi è più comodo lavorare sul foglio delle risposte collegato con il connettore Google Sheets.

Notifiche (facoltative): google_forms_create_watch invia un messaggio Cloud Pub/Sub quando arriva una risposta o il modulo cambia. Servono la Cloud Pub/Sub API e un topic nello stesso progetto Cloud del client OAuth, con il ruolo Pub/Sub Publisher assegnato a [email protected]. Un watch scade dopo 7 giorni se non viene rinnovato con google_forms_renew_watch.

Permessi: il connettore chiede https://www.googleapis.com/auth/forms.body (creare e modificare i moduli che il tuo account può modificare) e https://www.googleapis.com/auth/forms.responses.readonly (leggerne le risposte). Non include Google Drive, quindi il connettore non può elencare, cercare, condividere o eliminare i file dei moduli.

Solo lettura: cambia gli scope nelle impostazioni OAuth del connettore in https://www.googleapis.com/auth/forms.body.readonly https://www.googleapis.com/auth/forms.responses.readonly, autorizza di nuovo e disattiva google_forms_create_form, google_forms_add_text_question, google_forms_add_choice_question, google_forms_add_item, google_forms_update_form_info, google_forms_update_settings e google_forms_set_publish_settings.

Disattivati all'installazione: google_forms_batch_update, che può modificare ed eliminare domande, e google_forms_delete_watch. Attivali uno per uno se all'AI servono.

Le modifiche aspettano il tuo sì: prima di ogni modifica l'AI ti dice cosa creerà o cambierà e in quale modulo, e aspetta la tua conferma. Un modulo pubblicato è online: i partecipanti vedono subito le modifiche.

Limiti: Google consente a ogni utente 150 modifiche e 180 letture di elenchi di risposte al minuto. Oltre il limite risponde 429: aspetta un minuto e riprova.

Errori comuni: 401 significa che l'autorizzazione è scaduta o è stata revocata (succede sempre dopo 7 giorni se la schermata di consenso è in Testing): clicca di nuovo su Authorize with Provider. 403 PERMISSION_DENIED significa che l'account non può modificare quel modulo, o che lo scope non consente la chiamata; 403 "Forms API has not been used in project" significa che la Google Forms API non è abilitata nel progetto Cloud. 404 di solito significa che l'id viene dal link per i partecipanti invece che dal link di modifica, oppure che il modulo è stato eliminato. Un 400 quando si aggiunge una domanda significa che la posizione è oltre la fine del modulo, o che una domanda a scelta ha opzioni duplicate o vuote.

Il connettore non condivide, copia o elimina moduli (lo fa il connettore Google Drive), non può modificare o eliminare risposte (la Forms API non lo consente) e non esegue Apps Script.

Step 2 — Installa l'adapter

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

Step 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Google Forms.

Tool disponibili

Esempi di prompt

• "Crea un modulo di feedback dei clienti con una valutazione da 1 a 5, una domanda a scelta multipla su come ci hanno trovato e un paragrafo per i commenti, poi pubblicalo e dammi il link."
• "Riassumi le risposte di questa settimana al modulo di iscrizione ai workshop e conta gli iscritti per ogni workshop."
• "Trasforma il quiz di onboarding in un quiz con punteggio e raccogli gli indirizzi email dei partecipanti."
• "Chiudi il sondaggio del team a nuove risposte: ne abbiamo abbastanza."

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Meta Muse