Google Contacts MCP Server

Allow AI systems to list, search, and manage contacts via Google Contacts. Its 15 documented tools cover contact, group, contacts, photo. It runs locally over stdio via the published package.

People connecting this server to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-11 · ★ 3 · #343 OF 848 MAINTAINED OTHER · VERIFIED 2026-08-25

TypeScript servers · how we verify → /methodology

01 · Install Google Contacts

before you install - you'll need

Set GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, MCP_TRANSPORT before connecting.

Claude Code

claude mcp add domdomegg-google-contacts-mcp -- npx -y google-contacts-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "domdomegg-google-contacts-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "google-contacts-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license no standard license detected - usage rights unclear; check the repo before commercial use

npm package google-contacts-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.domdomegg is GitHub-verified and matches the repo owner

03 · What Google Contacts can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can search contacts by name, email, or phone, search organization directory for coworkers, get detailed info for a single contact, and create a new contact.

Capability map

Tools grouped from the project's README - what Google Contacts lets an agent do.

Contact

12 tools - e.g. Get detailed info for a single contact; Create a new contact; Update an existing contact

contact_get · contact_create · contact_update · contact_delete · contact_photo_update · contact_photo_delete…

Contacts

2 tools - e.g. List contacts with names, emails, phones, organizations, birthdays, events, URLs, addresses, nicknames, relations, IM usernames, genders, external IDs, client d; Search contacts by name, email, or phone

contacts_list · contacts_search

Latest releases

v1.3.0 · 2026-07-27

Bump body-parser from 2.2.1 to 2.3.0 · Bump fast-uri from 3.1.3 to 3.1.4 · Bump postcss from 8.5.16 to 8.5.23 · Claude/official api gaps 5e8uwa

v1.2.0 · 2026-07-09

link install-mcp for adding the server to clients · Report the package.json version instead of a hardcoded literal · Add birthdays, contact groups, URLs, addresses, events and custom fields to contacts · Bump vitest…

v1.1.4 · 2026-05-25

Add annotations to write tools

04 · Who maintains Google Contacts

Google Contacts is maintained by domdomegg. We track 17 MCP servers from domdomegg - 17 actively maintained, 861 combined GitHub stars, oldest repo from Dec 2024. Full record: all servers from domdomegg.

05 · Facts

repository: github.com/domdomegg/google-contacts-mcp
website: https://github.com/domdomegg/google-contacts-mcp#readme
category: other - ranked #343 of 848 actively-maintained other servers as of 2026-08-25.
release cadence: 2 releases in the last 90 days (latest 2026-07-27)
registry: io.github.domdomegg/google-contacts-mcp (active, first published 2025-12-11 · 9 versions)
packages: npm:google-contacts-mcp · npm:google-contacts-mcp

06 · Google Contacts FAQ

Is Google Contacts still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-11 and it shipped 2 releases in the last 90 days. We re-verify nightly.

What can Google Contacts do?

With this server connected, an agent can search contacts by name, email, or phone, search organization directory for coworkers, get detailed info for a single contact, and create a new contact.

How do I install Google Contacts?

Run `npx -y google-contacts-mcp`. The README documents 3 environment variables (GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, MCP_TRANSPORT) to set first. Set GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, MCP_TRANSPORT before connecting. You can also paste the ready-made client config above.

Does Google Contacts run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Google Contacts

Alternatives to Google Contacts

Maintained other servers if Google Contacts isn't the fit.

More MCP servers to compare · Google Sheets · Shell Exec · Starling Bank · Domain Search MCP · fcp-MCP - Final Cut Pro MCP Server

More TypeScript MCP servers · Google Docs · Google Drive · Open Food Facts · see all