# Google Contacts MCP

> Google Contacts MCP is an open-source MCP server for productivity. Manage Google Contacts in plain language: search, edit, label and batch-import. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Repository:** https://github.com/a1-x-tech/mcp-google-contacts
- **MCP Registry name:** io.github.A1-x-Tech/mcp-google-contacts
- **Categories:** [productivity](https://ai-powered.com/categories/productivity), [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-18

## About

Connection happens inside the chat. You ask the assistant to connect Google Contacts and it walks through creating an OAuth client, catches Google's redirect on 127.0.0.1 with PKCE and keeps the tokens itself, so no config files or restarts are needed. Alternatively you can supply an OAuth client id, secret and refresh token, or a short-lived access token for testing.

The 25 tools cover listing, searching and reading contacts, creating, updating and deleting them singly or in batches, managing contact groups and membership, and reading Google's automatically saved Other contacts and copying them into My Contacts. Updates are guarded by an etag, so a contact changed elsewhere causes the write to fail rather than being overwritten. Reads use field masks to stay compact.

The README is open about limits: deletes are permanent because the People API has no trash, search can lag recent writes by seconds and returns at most 30 results, Other contacts cannot be edited in place, and photos have no dedicated tool. It requests the narrow contacts scope, or read-only if you prefer.

## Features

- **In-chat OAuth:** Connect from the conversation with PKCE on a loopback port.
- **Etag-guarded updates:** Stale writes fail instead of overwriting.
- **Batch operations:** Create, update or delete many contacts in one call.
- **Label management:** Create and rename groups and manage membership.
- **Other contacts:** Read auto-saved addresses and copy them into contacts.
- **Minimal scopes:** Contacts scope, or read-only, plus a separate Other-contacts scope.

## Good for

- Find everyone from a company with emails and phones
- Update a phone number and add a contact to a label
- Import fifty people in one batch
- Promote an auto-saved address to a real contact

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-google-contacts --env GOOGLE_CONTACTS_CLIENT_SECRET='<GOOGLE_CONTACTS_CLIENT_SECRET>' --env GOOGLE_CONTACTS_REFRESH_TOKEN='<GOOGLE_CONTACTS_REFRESH_TOKEN>' --env GOOGLE_CONTACTS_ACCESS_TOKEN='<GOOGLE_CONTACTS_ACCESS_TOKEN>' -- npx -y mcp-google-contacts
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-google-contacts": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-contacts"
      ],
      "env": {
        "GOOGLE_CONTACTS_CLIENT_SECRET": "<GOOGLE_CONTACTS_CLIENT_SECRET>",
        "GOOGLE_CONTACTS_REFRESH_TOKEN": "<GOOGLE_CONTACTS_REFRESH_TOKEN>",
        "GOOGLE_CONTACTS_ACCESS_TOKEN": "<GOOGLE_CONTACTS_ACCESS_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-google-contacts": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-contacts"
      ],
      "env": {
        "GOOGLE_CONTACTS_CLIENT_SECRET": "<GOOGLE_CONTACTS_CLIENT_SECRET>",
        "GOOGLE_CONTACTS_REFRESH_TOKEN": "<GOOGLE_CONTACTS_REFRESH_TOKEN>",
        "GOOGLE_CONTACTS_ACCESS_TOKEN": "<GOOGLE_CONTACTS_ACCESS_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-google-contacts": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-contacts"
      ],
      "env": {
        "GOOGLE_CONTACTS_CLIENT_SECRET": "<GOOGLE_CONTACTS_CLIENT_SECRET>",
        "GOOGLE_CONTACTS_REFRESH_TOKEN": "<GOOGLE_CONTACTS_REFRESH_TOKEN>",
        "GOOGLE_CONTACTS_ACCESS_TOKEN": "<GOOGLE_CONTACTS_ACCESS_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-google-contacts": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-contacts"
      ],
      "env": {
        "GOOGLE_CONTACTS_CLIENT_SECRET": "<GOOGLE_CONTACTS_CLIENT_SECRET>",
        "GOOGLE_CONTACTS_REFRESH_TOKEN": "<GOOGLE_CONTACTS_REFRESH_TOKEN>",
        "GOOGLE_CONTACTS_ACCESS_TOKEN": "<GOOGLE_CONTACTS_ACCESS_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-google-contacts": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-contacts"
      ],
      "env": {
        "GOOGLE_CONTACTS_CLIENT_SECRET": "<GOOGLE_CONTACTS_CLIENT_SECRET>",
        "GOOGLE_CONTACTS_REFRESH_TOKEN": "<GOOGLE_CONTACTS_REFRESH_TOKEN>",
        "GOOGLE_CONTACTS_ACCESS_TOKEN": "<GOOGLE_CONTACTS_ACCESS_TOKEN>"
      }
    }
  }
}
```

## FAQ

### Is delete reversible?

No. The People API has no trash, so deletes are permanent and the tools are marked destructive.

### How many search results can I get?

At most 30, and the search cache can lag recent writes by a few seconds.

### Which Google permissions are needed?

The contacts scope for read/write, or contacts.readonly for read-only, plus contacts.other.readonly for Other contacts.

### Which clients are documented?

Codex, Claude Code, Claude Desktop, Cursor and VS Code.

### Is Google Contacts MCP free?

Yes. Google Contacts MCP is open source, so you can use and self-host it for free.

### How do I add Google Contacts MCP to Claude Code?

Run this command in your terminal: claude mcp add mcp-google-contacts --env GOOGLE_CONTACTS_CLIENT_SECRET='<GOOGLE_CONTACTS_CLIENT_SECRET>' --env GOOGLE_CONTACTS_REFRESH_TOKEN='<GOOGLE_CONTACTS_REFRESH_TOKEN>' --env GOOGLE_CONTACTS_ACCESS_TOKEN='<GOOGLE_CONTACTS_ACCESS_TOKEN>' -- npx -y mcp-google-contacts

### What are the best alternatives to Google Contacts MCP?

The closest alternatives to Google Contacts MCP are TrendRadar, Ha MCP, Concord MCP, Getmitra and note1.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [TrendRadar](https://ai-powered.com/mcp/trendradar): TrendRadar is an open-source MCP server for communication.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [Getmitra](https://ai-powered.com/mcp/getmitra): Getmitra is an MCP server for communication.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Discord](https://ai-powered.com/mcp/discord-2): Discord is a freemium MCP server for communication.
- [InviteKit Calendar Files](https://ai-powered.com/mcp/invitekit-calendar-files): InviteKit Calendar Files is an MCP server for files and documents.
- [Zoom](https://ai-powered.com/mcp/zoom): Zoom is a freemium MCP server for communication.

---
Source: https://ai-powered.com/mcp/google-contacts-mcp
