MCP.Market

Google Contacts MCP server

by domdomegg·io.github.domdomegg/google-contacts-mcp·v1.3.0·3 stars
No reviews yet

Allow AI systems to list, search, and manage contacts via Google Contacts.

B83/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B83/100

full report

Adoption
Growing

3 stars70 downloads/wk

Reviews

Write one

Nobody has reviewed Google Contacts yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Google Contacts tools (15, 8 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • contact_createwrite action

    Create a new contact in Google Contacts.

  • contact_deletewrite action

    Permanently delete a contact from Google Contacts.

  • contact_get

    Get detailed information about a single contact by resource name.

  • contact_group_createwrite action

    Create a new contact group (label) in Google Contacts.

  • contact_group_deletewrite action

    Permanently delete a contact group. System groups (e.g. "My Contacts", "Starred") cannot be deleted. By default this only removes the group/label; pass deleteContacts=true to also delete the member contacts.

  • contact_group_get

    Get detailed information about a single contact group, including its member resource names.

  • contact_group_members_modify

    Add or remove contacts from a contact group. Use this to manage which contacts belong to a group/label. This is the only way to change group membership - the People API does not support editing it via contact_update.

  • contact_group_updatewrite action

    Rename an existing contact group. Use contact_group_get first to retrieve the current etag. System groups (e.g. "My Contacts", "Starred") cannot be renamed.

  • contact_groups_list

    List contact groups (labels) from the user's Google Contacts, including system groups like "My Contacts" and "Starred".

  • contact_photo_deletewrite action

    Remove the photo from a contact, reverting to the default avatar.

  • contact_photo_updatewrite action

    Set (or replace) the photo for a contact. Provide the image as base64-encoded JPEG or PNG bytes.

  • contact_search

    Search for contacts by name, email, or phone number.

  • contact_updatewrite action

    Update an existing contact. Use contact_get first to retrieve the current etag.

  • contacts_list

    List contacts from the user's Google Contacts. Returns names, emails, phone numbers, organizations, birthdays, events, URLs, addresses, nicknames, relations, IM usernames, genders, external IDs, client data, and custom fields.

  • directory_search

    Search the organization directory for people (coworkers, etc). Requires directory.readonly scope.

Public scan report

scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it

no findings
  • Code scan47 source files scanned; 47 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 15 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Google Contacts compares

Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
83/100
higher than 70% of 3,471 Web search servers
Tools
15
the typical Web search server has 5
Tools that change things
53%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
3
more than 73% of 1,788 Web search servers
Downloads a week
70
more than 47% of 837 Web search servers with a package

What its tools let an agent do: 7 read · 8 change

Install Google Contacts in Claude Code, Cursor or VS Code

Runs npx -y google-contacts-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add google-contacts-mcp -- npx -y google-contacts-mcp
Add to Cursor

What the publisher says

From the Google Contacts repository's README, as published. We do not edit it. Read it on GitHub

google-contacts-mcp

MCP server for Google Contacts - list, search, and manage contacts.

Use Cases

Email lookup: "See the latest JIRA ticket that's come in. Can we email Sarah from the security team to get their input?" → finds Sarah's email and drafts the message.

Business card capture: After a networking event, snap photos of business cards → your assistant extracts the details and adds them as contacts with a note about where you met.

Find connections: "Who do I know at Google?" or "I'm visiting London next week - who should I catch up with?" → search your personal network.

Call reminder: "Remind me to call Mike at 3pm" → creates a calendar event with Mike's phone number attached so you can dial straight from the reminder.

Contact updates: You receive an out-of-office saying someone left their company with a new personal email → your assistant updates their contact automatically.

(These are just examples - any workflow that needs contact lookup or management can use this.)

Setup

1. Create Google OAuth credentials

  1. Go to Google Cloud Console
  2. Create a new project (or use existing)
  3. Enable the People API
  4. Go to APIs & Services → OAuth consent screen, set up consent screen
  5. Go to APIs & Services → Credentials → Create Credentials → OAuth client ID
  6. Choose Web application
  7. Add http://localhost:3000/callback to Authorized redirect URIs
  8. Note your Client ID and Client Secret

2. Run the server

GOOGLE_CLIENT_ID='your-client-id' \
GOOGLE_CLIENT_SECRET='your-client-secret' \
MCP_TRANSPORT=http \
npm start

The server runs on http://localhost:3000 by default. Change with PORT=3001.

3. Add to your MCP client

With the server running, follow the instructions on install-mcp, which generates the right config for your MCP client (Claude Code, Claude Desktop, Cursor, Cline, VS Code, and more).

Architecture

This server acts as an OAuth proxy to Google:

graph LR
    A[MCP client] <--> B[google-contacts-mcp] <--> C[Google OAuth/API]
  1. Server advertises itself as an OAuth authorization server via /.well-known/oauth-authorization-server
  2. /register returns the Google OAuth client credentials
  3. /authorize redirects to Google, encoding the client's callback URL in state
  4. /callback receives the code from Google and forwards to the client's callback
  5. /token proxies token requests to Google, injecting client credentials
  6. /mcp handles MCP requests, using the bearer token to call People API

The server holds no tokens or state - it just proxies OAuth to Google.

Tools

Contributing

Pull requests are welcomed on GitHub! To get started:

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Google Contacts: common questions

Is Google Contacts MCP server safe?
Mostly: it is graded B (83/100). Read the Google Contacts safety report
How do I install Google Contacts?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Google Contacts need an API key?
Yes. The registry entry asks for GOOGLE_ACCESS_TOKEN, GOOGLE_CLIENT_SECRET.
Is Google Contacts maintained?
The last commit was 56 days ago (2026-09-09). The latest release is v1.3.0.
What can I use instead of Google Contacts?
Servers from other publishers that do the same job: Google Maps MCP Server, Abap Adt Ro MCP server and Apple Contacts MCP server.
How does Google Contacts compare with other Web search MCP servers?
safety score 83/100 (higher than 70% of 3,471 Web search servers); tools 15 (the typical Web search server has 5); tools that change things 53% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Google Contacts

Same job from other publishers: the closest match first, then the best rated.

  • Google Maps MCP Server
    18 Google Maps tools for AI agents — geocode, search, directions, weather, and more.
    B
  • Abap Adt Ro
    Read-only MCP server for SAP ABAP ADT over HTTP, RFC or SNC: the readonly, system and search tools
    A
  • Apple Contacts
    Inspect and search Apple Contacts on macOS, and resolve a contact into a message-ready recipient.
    A
  • Suede AI Skills MCP
    Routes tasks to Suede skills, grades live pages A-F for Google and AI search, and checks copy.
    A
  • SerpApi
    Official SerpApi MCP server for Google, Bing, and other search engines.
    A

More from domdomegg →