Come collegare Google Docs a Gemini via MCP

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

Google Docs + Gemini

Fai lavorare la tua AI con Google Docs: leggi un documento come testo semplice o come titoli e paragrafi con le loro posizioni, crea nuovi documenti, aggiungi o inserisci testo e sostituisci il testo ovunque, per esempio per compilare un modello. 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 Docs 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 documenti. 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 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 documento: incolla il link del documento nella chat; il suo id è la stringa lunga in https://docs.google.com/document/d/<id>/edit. Per trovare i documenti per nome, aggiungi anche il connettore Google Drive. Il connettore legge la prima scheda di un documento; i documenti molto lunghi o con più schede si leggono meglio con il connettore Google Drive. Sostituire il testo ovunque è il modo affidabile per compilare un modello con segnaposto come [Nome cliente].

Permessi: il connettore chiede https://www.googleapis.com/auth/documents: leggere e modificare ogni documento che il tuo account può aprire. Non include Google Drive, quindi il connettore non può elencare, cercare, condividere o eliminare documenti.

Solo lettura: cambia lo scope nelle impostazioni OAuth del connettore in https://www.googleapis.com/auth/documents.readonly, autorizza di nuovo e disattiva gdocs_create_document, gdocs_append_text, gdocs_insert_text e gdocs_replace_all_text.

Disattivati all'installazione: gdocs_batch_update, che accetta qualsiasi richiesta della Docs API, compresa l'eliminazione di contenuti. Attivalo solo se all'AI serve.

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ò aprire o modificare quel documento, o che lo scope è in sola lettura; 403 "Docs API has not been used in project" significa che la Google Docs API non è abilitata nel progetto Cloud. 404 significa che l'id è sbagliato o appartiene a un altro tipo di file, per esempio un foglio di calcolo o un file Word caricato su Drive.

Il connettore non gestisce commenti e suggerimenti, non condivide, sposta o elimina documenti (lo fa il connettore Google Drive) e non modifica i file Word salvati su Drive.

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 Docs.

Tool disponibili

Esempi di prompt

• "Leggi questo verbale della riunione ed elenca tutte le attività con il rispettivo responsabile."
• "Compila il modello di contratto: sostituisci [Nome cliente] con Acme GmbH e [Data di inizio] con 1 novembre 2026."
• "Aggiungi una sezione Prossimi passi alla fine del brief di progetto."
• "Crea un nuovo documento Checklist di onboarding e scrivici una prima bozza."

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