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
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-mcpWhat 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-mcpReplace <…> with your own values
Platform CLI
codex mcp add google-contacts --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> -- npx -y google-contacts-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"google-contacts": {
"command": "npx",
"args": [
"-y",
"google-contacts-mcp"
],
"env": {
"GOOGLE_ACCESS_TOKEN": "<GOOGLE_ACCESS_TOKEN>",
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"google-contacts": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"google-contacts-mcp"
],
"env": {
"GOOGLE_ACCESS_TOKEN": "<GOOGLE_ACCESS_TOKEN>",
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e GOOGLE_ACCESS_TOKEN=<GOOGLE_ACCESS_TOKEN> -e MCP_TRANSPORT=<MCP_TRANSPORT> -e GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> -e GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> google-contacts npx -y google-contacts-mcpReplace <…> 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.