Log inSubmit server
Google Contacts MCP logo

Google Contacts MCP

Manage Google Contacts and groups through MCP, including searches, batch changes, labels, and selected Other contacts operations.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Google Contacts MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "google-contacts-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-contacts@latest"
      ],
      "env": {
        "GOOGLE_CONTACTS_CLIENT_ID": "YOUR_VALUE_HERE",
        "GOOGLE_CONTACTS_CLIENT_SECRET": "YOUR_VALUE_HERE",
        "GOOGLE_CONTACTS_REFRESH_TOKEN": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 25 tools correctly (8d ago).

Overview

Google Contacts MCP connects AI clients to the Google People API for reading and managing contacts, groups, labels, and selected Other contacts records. It exposes 25 tools for searches, CRUD operations, batch processing, group membership, and raw API requests. OAuth can be initiated from the conversation using a local PKCE redirect, while updates use etags to avoid overwriting concurrent edits. Reach for it when an agent needs controlled address-book maintenance rather than read-only contact lookup.

Use cases

  • Find contacts by organization and display their emails or phone numbers
  • Create or update contacts from conversational instructions
  • Import or delete contacts in batches
  • Organize contacts with groups and labels
  • Copy automatically saved addresses into My Contacts

Key features

  • Google People API contact and group management
  • Search and batch contact operations
  • Et​​ag-guarded updates
  • OAuth with PKCE and local redirect handling
  • Other contacts read and copy support
  • Raw People API requests

Tools25

What Google Contacts MCP lets your agent do. Expand a tool for its parameters.

Verified live~10.3k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

12/12 checks healthy over the last 66d

What it can do

From the 25 tools this server returned when we ran it; 25 declare their own safety hints.

Can delete or modify data · 9Handles credentials · 8Makes network requests · 25Read-only tools · 16
Network at startup4 connections
Files written at startup1
Install scriptsprepare
npm provenanceNot published
Package age66 days
Maintainers1

Observed 2026-11-04 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 4d ago via OSV.dev · mcp-google-contacts@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads1kPackage downloads in the last 30 days.
Last commit7d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed25Callable tools this server registers over MCP.

How Google Contacts MCP works

What Google Contacts MCP does

Google Contacts MCP gives an MCP-compatible AI client access to a Google account's address book through the Google People API. It supports contact searches and reads, individual and batch creation, updates, and deletion. Agents can also create and manage contact groups, change group membership, and work with labels.

The server includes access to Google's “Other contacts” collection, which contains addresses saved automatically by Google. These records can be read or copied into My Contacts, but they cannot be edited in place. A raw API request tool can reach endpoints that do not have dedicated tools, including contact-photo operations.

How it works

Records are addressed by the resource names returned by the People API, such as people/c..., contactGroups/..., and otherContacts/.... Reads use field masks; the default set includes names, email addresses, phone numbers, organizations, and group memberships. A field outside the selected mask may not appear even when it exists in Google Contacts.

Contact updates replace each supplied field group as a unit and require the record's etag. If another change happened after the record was read, the write fails rather than silently replacing that change. Deletion is permanent because the People API does not provide a trash or undo operation. Search results can lag recent writes by a few seconds and are limited to 30 results.

Setup and configuration

Node.js 20 or newer and a Google account are required. Install the npm stdio package with an MCP client, for example:

Terminal
npx -y mcp-google-contacts@latest

The connection flow can be started by telling the assistant to “connect Google Contacts.” It guides the user through creating an OAuth client and approving access, receives Google's redirect on 127.0.0.1 using PKCE, and stores the tokens without requiring a configuration file or restart.

The documented environment variables are:

  • GOOGLE_CONTACTS_CLIENT_ID
  • GOOGLE_CONTACTS_CLIENT_SECRET
  • GOOGLE_CONTACTS_REFRESH_TOKEN

The server uses the contacts scope for read/write access. A read-only setup can use contacts.readonly; the separate contacts.other.readonly scope is used for Other contacts.

Tools and capabilities

The 25 tools cover the following operations:

  • List, search, read, and batch-read contacts and groups.
  • Create, update, delete, and batch-process contacts.
  • Create, rename, and delete groups.
  • Add or remove contacts from groups and labels.
  • Read Other contacts and copy them into My Contacts.
  • Send raw requests to People API endpoints.

Clients can expose destructive operations for confirmation before execution. Group deletion can optionally remove member contacts, but that behavior requires an explicit request.

Limitations and notes

Other contacts are read-only except for copying a record into My Contacts. Search is cached and may not immediately reflect a write. Contact and group deletion cannot be undone through the People API. Updates operate on complete supplied field groups, so callers should read the relevant record and provide the intended replacement values. Contact photos do not have a dedicated tool and require the raw request capability.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Google Contacts MCP

Google Contacts MCP is an MCP server that connects AI clients to the Google People API. Its main tools search, read, create, update, delete, and batch-process contacts, manage groups and memberships, and read or copy Google’s Other contacts into My Contacts.

Install it as an npm stdio server with `npx -y mcp-google-contacts@latest`. Add that command to an MCP client such as Codex, Claude Code, Claude Desktop, Cursor, or VS Code, then start the OAuth connection from the conversation.

Tell the assistant “connect Google Contacts.” The server guides you through OAuth client setup and access approval, handles the redirect on `127.0.0.1` with PKCE, and stores the resulting tokens itself.

Yes. Contact writes are protected by etags, so an update fails when the contact changed elsewhere after it was read instead of silently overwriting the newer edit.

No. Other contacts can be read or copied into My Contacts, but they cannot be edited in place. The copied record becomes a regular contact that can be managed through the standard contact tools.

Related MCP servers

All in Workplace & Productivity All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewGoogle Contacts MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/google-contacts-mcp?style=directory)](https://allmcps.com/mcp/google-contacts-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/google-contacts-mcp"><img src="https://allmcps.com/api/badge/google-contacts-mcp?style=directory" alt="Google Contacts MCP on AllMCPs" /></a>