Skip to main content
MCP server CX Codex

Google Contacts — Claude Code MCP server for Google contact access

An MCP server for Claude Code and seven other clients that lets agents list, search, and modify Google contacts. Runs as a local OAuth proxy and keeps no tokens.

no license ★ 6 updated 2026-10-21

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add --env GOOGLE_ACCESS_TOKEN=<GOOGLE_ACCESS_TOKEN> --env MCP_TRANSPORT=<MCP_TRANSPORT> --env GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> --env GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> --transport stdio google-contacts -- npx -y google-contacts-mcp
Open on GitHub

What Google Contacts does

The server connects your agent to Google Contacts: names, emails, phones, organizations, birthdays, addresses, and more. Works with Claude Code, Codex, Cursor, GitHub Copilot, Windsurf, Cline, Zed, and Gemini CLI.\n\nIt runs as an OAuth proxy on http://localhost:3000 and holds no tokens or state. The server announces itself as an authorization server at /.well-known/oauth-authorization-server, redirects to Google, and forwards requests to the People API. You need GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET, and the port can be changed with PORT.\n\nFifteen tools are available, from contacts_list and contacts_search to group management. Contacts can be created, updated, or permanently deleted, and there are separate tools for photos and groups. contact_delete removes a contact for good with no extra confirmation from Google, so be careful which agent you hand that to.

What it helps with

  • look up an email or phone number by name
  • add contacts from business card photos after an event
  • find people in your network who work at a specific company
  • update a contact after an out-of-office reply
  • group contacts and adjust membership

Example prompts for the agent

  • Find Sarah from the security team's email and draft a message to her.
  • Here are photos of business cards — add these contacts with a note about where we met.
  • Who in my contacts works at Google?

How to install Google Contacts

Platform CLI

claude mcp add --env GOOGLE_ACCESS_TOKEN=<GOOGLE_ACCESS_TOKEN> --env MCP_TRANSPORT=<MCP_TRANSPORT> --env GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> --env GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> --transport stdio google-contacts -- npx -y google-contacts-mcp

Replace <…> with your own values

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Google Contacts

How do I install Google Contacts in Claude Code?

Run claude mcp add google-contacts-mcp -e GOOGLE_ACCESS_TOKEN=<GOOGLE_ACCESS_TOKEN> -- npx -y google-contacts-mcp. Or use `claude mcp add --env GOOGLE_ACCESS_TOKEN=<GOOGLE_ACCESS_TOKEN> --env MCP_TRANSPORT=<MCP_TRANSPORT> --env GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> --env GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> --transport stdio google-contacts -- npx -y google-contacts-mcp`. First create an OAuth client in Google Cloud Console and enable the People API.

What does Google Contacts do?

It gives your agent access to Google Contacts: listing, search by name, email, or phone, creating and updating entries, deletion, photos, and groups. The agent can find someone and draft an email or reminder right away.

What permissions does it need?

The server uses OAuth. In Google Cloud Console you create a project, enable the People API, set up the consent screen, and get a Client ID and Client Secret. The redirect URI is http://localhost:3000/callback.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open