mcpbeat Sign in

Google Contacts MCP Server

local only

Google Contacts runs on your own machine — the client starts it, so there is no endpoint to ping. 138 installs a week from npm. Last commit 25 Oct 2026.

Allow AI systems to list, search, and manage contacts via Google Contacts.

Installs per day peak 17 · avg 8 · +5% w/w
a month agotoday
138
Installs / week
npm · google-contacts-mcp
5
Stars
2 open issues
25 Oct 2026
Last commit
1 release in 90 days
MIT
License
TypeScript

Nothing serious here today

Today is the operative word: we check Google Contacts every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add google-contacts-mcp -e 'MCP_TRANSPORT=<MCP_TRANSPORT>' -e 'GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID>' -e 'GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET>' -- npx -y google-contacts-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "google-contacts-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "google-contacts-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
        "MCP_TRANSPORT": "<MCP_TRANSPORT>"
      }
    }
  }
}
~/.codex/config.toml
[mcp_servers.google-contacts-mcp]
command = "npx"
args = ["-y", "google-contacts-mcp"]
env = { MCP_TRANSPORT = "<MCP_TRANSPORT>", GOOGLE_CLIENT_ID = "<GOOGLE_CLIENT_ID>", GOOGLE_CLIENT_SECRET = "<GOOGLE_CLIENT_SECRET>" }
.cursor/mcp.json
{
  "mcpServers": {
    "google-contacts-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "google-contacts-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
        "MCP_TRANSPORT": "<MCP_TRANSPORT>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "google-contacts-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "google-contacts-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
        "MCP_TRANSPORT": "<MCP_TRANSPORT>"
      }
    }
  }
}

Put your own values in place of <MCP_TRANSPORT> (Transport type), <GOOGLE_CLIENT_ID> (Google OAuth client ID), <GOOGLE_CLIENT_SECRET> (Google OAuth client secret). The author’s registry entry marks them as required.

Alternatives to Google Contacts

same job, measured the same way
Google Calendar
by domdomegg

Allow AI systems to list, create, update, and manage Google Calendar events.

118 installs/wk local only
Google Drive
by domdomegg

Allow AI systems to list, search, upload, download, and manage files and folders in Google Drive.

346 installs/wk local only
Google Maps Places
by domdomegg

Allow AI systems to search for places and get business info via Google Maps Places API.

93 installs/wk local only
Gtasks MCP
by alvinjchoi

Manage Google Tasks via MCP: list, search, create, update, move, and clear tasks.

171 installs/wk local only
Google Docs
by domdomegg

Allow AI systems to read and edit Google Docs.

123 installs/wk local only
Google Sheets
by domdomegg

Allow AI systems to read, write, and query spreadsheet data via Google Sheets.

324 installs/wk local only
Mewcp Google Calendar
by ammar-62

Schedule smarter - create, search, and manage Google Calendar events through AI.

local only
R
Refreshagent
by dunctk

Connect AI assistants to live Google Search Console and Analytics data through RefreshAgent.

40 installs/wk local only

Google Contacts — questions

Answers built from our own checks of this server.

Why is there no uptime for Google Contacts?
Google Contacts runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package google-contacts-mcp was installed 138 times last week.
How do I connect Google Contacts?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls google-contacts-mcp straight from npm; nothing to host, nothing to sign up for.
How many people use Google Contacts?
The npm package google-contacts-mcp was installed 138 times in the last week. Week over week that is +5%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Google Contacts open source?
Yes — it is published under the MIT licence, written in TypeScript, 5 stars on GitHub and 2 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.