Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi Google Contacts con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
In breve
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.
Prova a chiedere
Prompt di esempio per Google Contacts
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 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
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.
Setup
- Apri console.cloud.google.com, scegli o crea un progetto, poi vai su APIs & Services → Library e abilita la Google People API.
- 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".
- 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 invecehttps://tuo-host-anythingmcp/api/mcp-oauth/callback. - Inserisci il client ID in
GOOGLE_CLIENT_IDe il client secret inGOOGLE_CLIENT_SECRET, poi installa il connettore. - 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.
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 Contacts e inserisci le variabili elencate nei Prerequisiti.
Tool disponibili
| Tool | What it does |
|---|---|
google_contacts_list_contacts | List the user's saved Google Contacts with the fields asked for (names, emails, phones and organizations by default): resourceName, etag… |
google_contacts_get_contact | Read one contact in full: names, emails, phones, organizations, addresses, birthday, notes, websites, relations, events, group memberships… |
google_contacts_search_contacts | Search the user's saved contacts by the start of a name, nickname, email address, phone number or organization, e.g. "ana" or "acme" |
google_contacts_warm_up_search | Refresh the cache behind contact search with the empty request Google asks for, so the next search sees recent changes |
google_contacts_create_contact | Create a contact in the user's Google Contacts (My Contacts) |
google_contacts_update_contact | Change a contact. update_person_fields lists the fields to change, and each listed field is replaced as a whole: to add a second phone… |
google_contacts_delete_contact | Delete a contact from the user's Google Contacts; it disappears from their phone and Gmail too |
google_contacts_list_contact_groups | List the user's contact groups (labels) and the system groups: resourceName, name, formattedName, groupType (USER_CONTACT_GROUP or… |
google_contacts_get_contact_group | Read a contact group (label) with the resourceNames of its members (memberResourceNames), up to max_members |
google_contacts_create_contact_group | Create a contact group (label) with a name |
google_contacts_modify_group_members | Add contacts to a label or remove them from it (up to 1,000 together) |
google_contacts_list_other_contacts | List the user's "Other contacts": people Google saved automatically because the user emailed them, which are not in My Contacts |
google_contacts_search_other_contacts | Search the user's "Other contacts" (people they emailed but never saved) by the start of a name, email address or phone number |
google_contacts_save_other_contact | Save an "Other contact" into My Contacts, copying its name, email addresses and phone numbers |
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."
Prossimi passi
Questa guida ti è stata utile?
