Google Contacts

This Google Contacts MCP Server lets you list, search, and manage your Google contacts through MCP clients. It acts as an OAuth proxy to Google’s People API, enabling practical workflows like finding who you know at a company, extracting contact details from business cards, or updating contact information automatically.

How to use

You connect an MCP client to the Google Contacts MCP Server to access and modify your contacts. Start the server, then configure your MCP client to point at the server’s MCP endpoint. Use the available tools to list, search, create, update, or delete contacts, and to perform directory lookups.

Typical usage patterns include: list contacts to view names and emails, search by name or email, create new contacts from a business card, update a contact when an email changes, or delete a contact you no longer need. The server handles authentication with Google on your behalf and proxies requests through to the Google People API.

How to install

Prerequisites you need before installing:

Steps to install and run the server locally:

1. Create Google OAuth credentials in the Google Cloud Console and obtain a Client ID and Client Secret.

2. Start the server with your credentials and enable the MCP transport over HTTP.

3. Add the Google Contacts MCP to your MCP client configuration using the provided endpoint.

# Start the server (example with environment variables)
GOOGLE_CLIENT_ID='your-client-id' \
GOOGLE_CLIENT_SECRET='your-client-secret' \
MCP_TRANSPORT=http \
npm start

# The server runs by default at http://localhost:3000
# The MCP endpoint is typically at /mcp (http://localhost:3000/mcp)

3. Add to your MCP client configuration using the endpoint shown above.

claude mcp add --transport http google-contacts-mcp http://localhost:3000/mcp

Additional setup notes

The server advertises itself as an OAuth authorization service and proxies token requests to Google. It does not store tokens or state beyond what is needed to proxy the OAuth flow.

Configuration and endpoints

You configure the MCP client to talk to the server’s MCP endpoint. The server handles authentication with Google and forwards requests to the Google People API.

Tools and capabilities (endpoints)

The server exposes a set of tools to manage contacts and perform directory searches. These tools are available to MCP clients:

Security considerations

Treat your Google OAuth credentials as secrets. Do not share your Client ID or Client Secret. Use secure storage for environment variables and ensure your MCP client uses HTTPS in production.

Troubleshooting

If you cannot reach the MCP endpoint, verify that the server is running and that the port is accessible. Check that the Google OAuth credentials are correct and that the redirect URI is configured as shown during setup.

Available tools

contacts_list

List contacts with names, emails, phones, and organizations

contacts_search

Search contacts by name, email, or phone

directory_search

Search organization directory for coworkers

contact_get

Get detailed information for a single contact

contact_create

Create a new contact

contact_update

Update an existing contact

contact_delete

Permanently delete a contact