domdomegg avatar

Google Contacts

domdomegg/google-contacts-mcp

Connects Claude to Google Contacts through the People API, letting you list, search, create, update, and delete contacts programmatically. Works as an OAuth proxy so the server itself stays stateless while you authenticate directly with Google. Useful when you need Claude to look up email addresses or phone numbers from your network, add business cards after events, or update contact details on the fly. Supports both personal contacts and organization directory searches. Setup requires creating OAuth credentials in Google Cloud Console, then running the server locally with your client ID and secret. Available over HTTP transport with straightforward REST endpoint proxying to Google's services.

GitHub stars
5
tools
15
auth
Secret needed
transport
STDIO, HTTP
env vars
4
last updated
Jul 27, 2026

Tools

15 tools

Public tool metadata for what this MCP can expose to an agent.

contacts_listList contacts with names, emails, phones, organizations, birthdays, events, URLs, addresses, nicknames, relations, IM usernames, genders, external IDs, client data, and custom fields

List contacts with names, emails, phones, organizations, birthdays, events, URLs, addresses, nicknames, relations, IM usernames, genders, external IDs, client data, and custom fields

No parameter schema in public metadata yet.

contacts_searchSearch contacts by name, email, or phone

Search contacts by name, email, or phone

No parameter schema in public metadata yet.

directory_searchSearch organization directory for coworkers

Search organization directory for coworkers

No parameter schema in public metadata yet.

contact_getGet detailed info for a single contact

Get detailed info for a single contact

No parameter schema in public metadata yet.

contact_createCreate a new contact

Create a new contact

No parameter schema in public metadata yet.

contact_updateUpdate an existing contact

Update an existing contact

No parameter schema in public metadata yet.

contact_deletePermanently delete a contact

Permanently delete a contact

No parameter schema in public metadata yet.

contact_photo_updateSet or replace a contact's photo

Set or replace a contact's photo

No parameter schema in public metadata yet.

contact_photo_deleteRemove a contact's photo

Remove a contact's photo

No parameter schema in public metadata yet.

contact_groups_listList contact groups (labels)

List contact groups (labels)

No parameter schema in public metadata yet.

contact_group_getGet a contact group, including its members

Get a contact group, including its members

No parameter schema in public metadata yet.

contact_group_createCreate a new contact group

Create a new contact group

No parameter schema in public metadata yet.

contact_group_updateRename a contact group

Rename a contact group

No parameter schema in public metadata yet.

contact_group_deletePermanently delete a contact group

Permanently delete a contact group

No parameter schema in public metadata yet.

contact_group_members_modifyAdd or remove contacts from a contact group

Add or remove contacts from a contact group

No parameter schema in public metadata yet.

Sponsors

Configuration

GOOGLE_ACCESS_TOKEN*secret

Google OAuth access token.

MCP_TRANSPORT*default: http

Transport type.

GOOGLE_CLIENT_ID*

Google OAuth client ID.

GOOGLE_CLIENT_SECRET*secret

Google OAuth client secret.

Readme

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


View the full README on GitHub

Details

Repository
github.com/domdomegg/google-contacts-mcp
Website
github.com/domdomegg/google-contacts-mcp#readme
Category
Search & Web Crawling
Package
google-contacts-mcp
Transport
STDIO, HTTP
Auth
Required
Registry
MCP registry, active

More from domdomegg

Related Search & Web Crawling MCP servers

View all
1kiki830621 avatarChe Apple Mail Mcpkiki830621/che-apple-mail-mcpApple Mail MCP — 44 tools, SQLite millisecond search, .emlx parser, batch ops5stars
2pineapple-farm avatarSkill Historypineapple-farm/skill-historyTrack download history for 70,000+ agent skills. Search and get daily snapshots.5stars
3tigergraph avatarTigerGraphtigergraph/tigergraph-mcpExplore and evolve TigerGraph schemas, run GSQL and Cypher, load data, and search vector embeddings.5stars
41clawai avatar1Claw Vault1clawai/1claw-mcpHSM-backed vault secrets for AI agents (JIT fetch) plus prompt-injection and threat scanning.4stars
5adelelo13 avatarNeuromcpadelelo13/neuromcpSemantic memory for AI agents with hybrid search, knowledge graph, and consolidation4stars
6bielacki avatarBielacki Igdb Mcp Serverbielacki/igdb-mcp-serverExplore and discover video games from the Internet Game Database. Search titles, view detailed inf…4stars