Skip the install. Get this working in under 2 minutes.
Start a free trial on cloud.anythingmcp.com, add the Google Contacts in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.
AnythingMCP is listed in Claude's connector directory: add it to Claude in one click (opens in a new tab), then sign in and choose which MCP servers Claude may use.
Summary
Let your AI work with Google Contacts: search and read contacts with emails, phones, companies and addresses, create and update contacts, organise labels, and find people you emailed but never saved. Personal Google accounts and Google Workspace.
Try asking
Example prompts for Google Contacts
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Google Contacts, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
Google Contacts + Claude
Let your AI work with Google Contacts: search and read contacts with emails, phones, companies and addresses, create and update contacts, organise labels, and find people you emailed but never saved. Personal Google accounts and Google Workspace.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET
Step 1 — Get credentials
- Open console.cloud.google.com, pick or create a project, then go to APIs & Services → Library and enable the Google People API.
- Open APIs & Services → OAuth consent screen. Choose Internal if you are on Google Workspace (the simplest option), otherwise External. For External, set the publishing status to In production: while the app is in Testing, Google revokes its refresh tokens after 7 days and the connector stops working every week. For your own account you can click through the "unverified app" warning.
- Open APIs & Services → Credentials → Create credentials → OAuth client ID, choose the application type Web application and add the authorized redirect URI
https://cloud.anythingmcp.com/api/mcp-oauth/callback. If you host AnythingMCP yourself, enterhttps://your-anythingmcp-host/api/mcp-oauth/callbackinstead. - Paste the client ID into
GOOGLE_CLIENT_IDand the client secret intoGOOGLE_CLIENT_SECRET, then install the connector. - On the connector page, click Authorize with Provider and sign in with the Google account whose contacts the AI should use. The refresh token is stored encrypted and access tokens are renewed automatically.
One Google client for all Google connectors: the same Cloud project and OAuth client can serve every Google connector: Gmail, Google Calendar, Google Drive, Google Sheets, Google Docs, Google Slides, Google Forms, Google Contacts, Google Meet, Google Tasks, Search Console, Analytics and Ads. Enable each API in that project, reuse the same client ID and secret, and authorize each connector once. Each one asks only for its own permissions.
What it covers: your saved Google Contacts with their labels, and the "Other contacts" Google keeps for people you emailed but never saved. The connector works as the Google account that authorized it. The Google Workspace company directory is not included.
Search warm-up: Google's contact search runs on a cache. The AI refreshes it once at the start of a session with google_contacts_warm_up_search, waits a few seconds and then searches. Search matches the beginning of names, email addresses, phone numbers and companies, for example ana or acme. If a contact created a few minutes ago is still missing, the AI warms up again or lists the most recently changed contacts.
Adding and updating contacts: Google does not stop duplicates, so the AI searches before it creates a contact. An update replaces each field it names as a whole: to add a second phone number, the AI sends the existing numbers plus the new one. Changes are sent one after the other and can take a few minutes to show up in lists and search.
Labels and other contacts: the AI can create labels and add contacts to them or remove them; removing a contact from a label keeps the contact. An "Other contact" can be saved into your contacts with its name, email addresses and phone numbers.
Permissions: the connector asks for https://www.googleapis.com/auth/contacts (read and edit your contacts and labels) and https://www.googleapis.com/auth/contacts.other.readonly (read "Other contacts"). Both are sensitive scopes: outside your own Workspace organisation, Google shows the "unverified app" warning until the app is verified. For your own account you can click through it.
Read-only setup: change the scopes in the connector's OAuth settings to https://www.googleapis.com/auth/contacts.readonly https://www.googleapis.com/auth/contacts.other.readonly, authorize again and disable google_contacts_create_contact, google_contacts_update_contact, google_contacts_create_contact_group, google_contacts_modify_group_members and google_contacts_save_other_contact. To leave out "Other contacts", drop the second scope and disable google_contacts_list_other_contacts, google_contacts_search_other_contacts and google_contacts_save_other_contact.
Switched off at install: google_contacts_delete_contact. The API cannot restore a deleted contact, so turn it on only if the AI should delete contacts.
Changes wait for your yes: before every change the AI shows you the contact and the change, and waits for your confirmation. Contacts sync to your phone and to Gmail at once.
Common errors: 401 means the authorization expired or was revoked (always after 7 days while the consent screen is in Testing): click Authorize with Provider again. 403 PERMISSION_DENIED means the scope does not allow the call, for example in a read-only setup or without the "Other contacts" scope; 403 "People API has not been used in project" means the Google People API is not enabled in the Cloud project. 404 means the contact id is wrong or the contact was deleted. 400 failedPrecondition on an update means the contact changed in the meantime: the AI reads it again and retries.
The connector does not read the Google Workspace directory, does not upload contact photos and does not merge duplicates.
Step 2 — Install the 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 — Add the connector in Claude
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
Recommended path: works on claude.ai web without editing any config file.
- In Claude, open Customize → Connectors.
- Click +, then Add custom connector.
- Enter a name, e.g.
Google Contacts, and the remote MCP server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, then click Add. - Click Connect and sign in to AnythingMCP (OAuth) to allow access.
All tools below appear in your chat: start typing prompts.
Available tools
| 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 |
Example prompts
- "What is Ana García's mobile number, and which company is she with?"
- "Add Marco Rossi from Acme GmbH to my contacts: [email protected], +49 761 1234567."
- "Find the people at acme.example I emailed but never saved, and save them to my contacts."
- "Create a label Trade fair 2026 and add everyone from Acme and Globex to it."
- "Lukas Weber has a new mobile number, +49 170 5551234. Add it to his contact and keep the old one."
FAQ
Does it work with Claude Code as well as Claude Desktop? Yes, point both at https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Next steps
Was this guide helpful?
