Is Google Contacts free?

Yes, Google Contacts is free to use.

How do I install Google Contacts?

Google Contacts is a local plugin. Install it using npm package: google-contacts-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Google Contacts safe to use?

Google Contacts was flagged by MCP Marketplace's security scan, scoring 4.8/10 (high risk). It has 4 high or critical findings to review. Review the security report on this page carefully before installing it.

What credentials does Google Contacts need?

Google Contacts requires the following credentials or environment variables: GOOGLE_ACCESS_TOKEN, MCP_TRANSPORT, GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET. You can find setup instructions on the server detail page.

What AI apps work with Google Contacts?

Google Contacts uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Google Contacts MCP Server

by Domdomegg

Developer ToolsUse Caution4.8MCP RegistryLocal

Free

Server data from the Official MCP Registry

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

About

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

Security Report

4.8

Use Caution4.8High Risk

This is a well-architected MCP server for Google Contacts with proper OAuth2 authentication and authorization patterns. The server correctly implements stateless OAuth proxying, validates tokens before processing requests, and uses appropriate input validation via Zod schemas. Permissions align well with the stated purpose of contact management. A few minor code quality observations exist around error handling and logging, but no significant security vulnerabilities were identified. Supply chain analysis found 6 known vulnerabilities in dependencies (2 critical, 2 high severity). Package verification found 1 issue.

7 files analyzed · 12 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

process_spawn

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Google OAuth access token.Required

Environment variable: GOOGLE_ACCESS_TOKEN

Transport type.Optional

Environment variable: MCP_TRANSPORT

Google OAuth client ID.Optional

Environment variable: GOOGLE_CLIENT_ID

Google OAuth client secret.Required

Environment variable: GOOGLE_CLIENT_SECRET

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-domdomegg-google-contacts-mcp": {
      "env": {
        "MCP_TRANSPORT": "your-mcp-transport-here",
        "GOOGLE_CLIENT_ID": "your-google-client-id-here",
        "GOOGLE_ACCESS_TOKEN": "your-google-access-token-here",
        "GOOGLE_CLIENT_SECRET": "your-google-client-secret-here"
      },
      "args": [
        "-y",
        "google-contacts-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

google-contacts-mcp

MCP server for Google Contacts - list, search, and manage contacts.

Use Cases

Email lookup: "See the latest JIRA ticket that's come in. Can we email Sarah from the security team to get their input?" → finds Sarah's email and drafts the message.

Business card capture: After a networking event, snap photos of business cards → your assistant extracts the details and adds them as contacts with a note about where you met.

Find connections: "Who do I know at Google?" or "I'm visiting London next week - who should I catch up with?" → search your personal network.

Call reminder: "Remind me to call Mike at 3pm" → creates a calendar event with Mike's phone number attached so you can dial straight from the reminder.

Contact updates: You receive an out-of-office saying someone left their company with a new personal email → your assistant updates their contact automatically.

(These are just examples - any workflow that needs contact lookup or management can use this.)

Setup

1. Create Google OAuth credentials

Go to Google Cloud Console
Create a new project (or use existing)
Enable the People API
Go to APIs & Services → OAuth consent screen, set up consent screen
Go to APIs & Services → Credentials → Create Credentials → OAuth client ID
Choose Web application
Add http://localhost:3000/callback to Authorized redirect URIs
Note your Client ID and Client Secret

2. Run the server

GOOGLE_CLIENT_ID='your-client-id' \
GOOGLE_CLIENT_SECRET='your-client-secret' \
MCP_TRANSPORT=http \
npm start

The server runs on http://localhost:3000 by default. Change with PORT=3001.

3. Add to your MCP client

With the server running, follow the instructions on install-mcp, which generates the right config for your MCP client (Claude Code, Claude Desktop, Cursor, Cline, VS Code, and more).

Architecture

This server acts as an OAuth proxy to Google:

graph LR
    A[MCP client] <--> B[google-contacts-mcp] <--> C[Google OAuth/API]

Server advertises itself as an OAuth authorization server via /.well-known/oauth-authorization-server
/register returns the Google OAuth client credentials
/authorize redirects to Google, encoding the client's callback URL in state
/callback receives the code from Google and forwards to the client's callback
/token proxies token requests to Google, injecting client credentials
/mcp handles MCP requests, using the bearer token to call People API

The server holds no tokens or state - it just proxies OAuth to Google.

Tools

Tool	Description
`contacts_list`	List contacts with names, emails, phones, organizations, birthdays, events, URLs, addresses, nicknames, relations, IM usernames, and custom fields
`contacts_search`	Search contacts by name, email, or phone
`directory_search`	Search organization directory for coworkers
`contact_get`	Get detailed info for a single contact
`contact_create`	Create a new contact
`contact_update`	Update an existing contact
`contact_delete`	Permanently delete a contact
`contact_photo_update`	Set or replace a contact's photo
`contact_photo_delete`	Remove a contact's photo
`contact_groups_list`	List contact groups (labels)
`contact_group_get`	Get a contact group, including its members
`contact_group_create`	Create a new contact group
`contact_group_update`	Rename a contact group
`contact_group_delete`	Permanently delete a contact group
`contact_group_members_modify`	Add or remove contacts from a contact group

Contributing

Pull requests are welcomed on GitHub! To get started:

Install Git and Node.js
Clone the repository
Install dependencies with npm install
Run npm run test to run tests
Build with npm run build

Releases

Versions follow the semantic versioning spec.

To release:

Use npm version <major | minor | patch> to bump the version
Run git push --follow-tags to push with tags
Wait for GitHub Actions to publish to the NPM registry.

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

Google Contacts MCP Server

About

Security Report

Findings (12)Action required

Permissions Required

What You'll Need

How to Install

Documentation

google-contacts-mcp

Use Cases

Setup

1. Create Google OAuth credentials

2. Run the server

3. Add to your MCP client

Architecture

Tools

Contributing

Releases

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Toleno

mcp-creator-python

MarkItDown

MCP Marketplace

FinAgent