# Google Contacts

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 repo stars
- Author: domdomegg
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/domdomegg/google-contacts-mcp
- Updated: 2026-10-21
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/google-contacts

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `GOOGLE_ACCESS_TOKEN`, `MCP_TRANSPORT`, `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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

### Codex

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

## When to use it
- 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
- 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?

## Similar
- [recipe-sync-contacts-to-sheet](https://affpapa.org/en/nevibecode/skills/recipe-sync-contacts-to-sheet.md) — skill · 31700 installs
- [c-contacts](https://affpapa.org/en/nevibecode/skills/c-contacts.md) — skill · ★ 179 repo stars
- [google-ads-api-mcp-setup](https://affpapa.org/en/nevibecode/skills/google-ads-api-mcp-setup.md) — skill · 6910 installs
- [sent-contacts](https://affpapa.org/en/nevibecode/skills/sent-contacts.md) — skill · 2900 installs
- [google-calendar](https://affpapa.org/en/nevibecode/mcp/google-calendar.md) — MCP server · ★ 81 repo stars
- [google-drive-automation](https://affpapa.org/en/nevibecode/skills/google-drive-automation.md) — skill · 917 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
