Come collegare Google Contacts a Cursor via MCP

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

Google Contacts + Cursor

Fai lavorare la tua AI con Google Contacts: cerca e leggi i contatti con email, telefoni, aziende e indirizzi, crea e aggiorna contatti, organizza le etichette e trova le persone a cui hai scritto ma che non hai mai salvato. 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 People 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 contatti. 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.

Cosa copre: i tuoi contatti Google salvati con le loro etichette, e gli "Altri contatti" che Google conserva per le persone a cui hai scritto ma che non hai mai salvato. Il connettore lavora come l'account Google che lo ha autorizzato. La directory aziendale di Google Workspace non è inclusa.

Preparare la ricerca: la ricerca dei contatti di Google usa una cache. All'inizio di una sessione l'AI la aggiorna una volta con google_contacts_warm_up_search, aspetta qualche secondo e poi cerca. La ricerca trova l'inizio di nomi, indirizzi email, numeri di telefono e aziende, per esempio ana o acme. Se manca un contatto creato pochi minuti prima, l'AI aggiorna di nuovo la cache o elenca i contatti modificati più di recente.

Aggiungere e aggiornare contatti: Google non blocca i duplicati, quindi l'AI cerca prima di creare un contatto. Un aggiornamento sostituisce per intero ogni campo indicato: per aggiungere un secondo numero di telefono, l'AI invia i numeri esistenti insieme a quello nuovo. Le modifiche vengono inviate una dopo l'altra e possono impiegare qualche minuto a comparire negli elenchi e nella ricerca.

Etichette e altri contatti: l'AI può creare etichette e aggiungervi o togliervi contatti; togliere un contatto da un'etichetta non lo elimina. Un "Altro contatto" si può salvare tra i tuoi contatti con nome, indirizzi email e numeri di telefono.

Permessi: il connettore chiede https://www.googleapis.com/auth/contacts (leggere e modificare i tuoi contatti e le etichette) e https://www.googleapis.com/auth/contacts.other.readonly (leggere gli "Altri contatti"). Sono entrambi scope sensibili: fuori dalla tua organizzazione Workspace, Google mostra l'avviso "unverified app" finché l'app non è verificata. Per il tuo account puoi semplicemente proseguire.

Solo lettura: cambia gli scope nelle impostazioni OAuth del connettore in https://www.googleapis.com/auth/contacts.readonly https://www.googleapis.com/auth/contacts.other.readonly, autorizza di nuovo e disattiva google_contacts_create_contact, google_contacts_update_contact, google_contacts_create_contact_group, google_contacts_modify_group_members e google_contacts_save_other_contact. Per escludere gli "Altri contatti", togli il secondo scope e disattiva google_contacts_list_other_contacts, google_contacts_search_other_contacts e google_contacts_save_other_contact.

Disattivati all'installazione: google_contacts_delete_contact. L'API non può ripristinare un contatto eliminato, quindi attivalo solo se l'AI deve eliminare contatti.

Le modifiche aspettano il tuo sì: prima di ogni modifica l'AI ti mostra il contatto e la modifica, e aspetta la tua conferma. I contatti si sincronizzano subito con il telefono e con Gmail.

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 lo scope non consente la chiamata, per esempio con una configurazione in sola lettura o senza lo scope per gli "Altri contatti"; 403 "People API has not been used in project" significa che la Google People API non è abilitata nel progetto Cloud. 404 significa che l'id del contatto è sbagliato o che il contatto è stato eliminato. 400 failedPrecondition su un aggiornamento significa che nel frattempo il contatto è cambiato: l'AI lo rilegge e riprova.

Il connettore non legge la directory di Google Workspace, non carica foto dei contatti e non unisce i duplicati.

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 Cursor

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.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di Google Contacts.

Tool disponibili

Esempi di prompt

• "Qual è il cellulare di Ana García e per quale azienda lavora?"
• "Aggiungi Marco Rossi di Acme GmbH ai miei contatti: [email protected], +49 761 1234567."
• "Trova le persone di acme.example a cui ho scritto ma che non ho mai salvato, e salvale nei miei contatti."
• "Crea un'etichetta Fiera 2026 e aggiungici tutti i contatti di Acme e Globex."
• "Lukas Weber ha un nuovo cellulare, +49 170 5551234. Aggiungilo al suo contatto e tieni anche quello vecchio."

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

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