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.
Configurazione guidata
Collega Google Contacts a Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Google Contacts con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
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 + Microsoft Copilot
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
- 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.
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 Microsoft Copilot
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 mostraYOUR_SERVER_ID.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Google Contacts. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.
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."
FAQ
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
Questa guida ti è stata utile?