Google Contacts MCP
Provides tools for managing Google Contacts, including listing, searching, fetching, creating, updating, and deleting contacts, as well as counting contacts via the Google People API.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Google Contacts MCP
A small, local Model Context Protocol server for Google Contacts (Google People API).
Security model
This repository intentionally contains no credentials and does not implement OAuth login or redirects.
Set
GOOGLE_CONTACTS_TOKEN_PATHto an absolute path for an OAuth authorized-user token stored outside this repository.The server never falls back to a default token path, so it cannot accidentally select a different Google account.
.gitignorerejects token, secret and credential JSON files.On each refresh, the token file is written with Unix permission
0600.Write operations require
confirm: truein the tool input.
Do not commit your OAuth token or client-secret JSON. If a credential is ever committed, revoke it immediately in Google Cloud and remove it from Git history.
Related MCP server: Google Contacts MCP Server
Tools
Tool | Purpose |
| List one page of contacts. |
| Search all contacts locally by all words across name, email and phone. |
| Fetch a contact by People API resource name. |
| Create a contact; requires |
| Update supplied fields; requires |
| Permanently delete a contact; requires |
| Count all contacts. |
list_contacts, search_contacts e get_contact retornam também tags: os nomes dos rótulos/grupos do Google Contacts vinculados ao contato. Isso permite que consumidores apliquem políticas como ignorar contatos com a tag Não Atualizar Automático sem depender de texto no nome ou em campos pessoais.
Requirements
Node.js 18 or newer.
An OAuth refresh token authorized for
https://www.googleapis.com/auth/contacts.Google People API enabled in the token's Google Cloud project.
Install
npm install
export GOOGLE_CONTACTS_TOKEN_PATH=/absolute/path/outside-this-repo/google_token.json
node index.jsFor a Hermes stdio MCP configuration, point the command at node, pass the absolute index.js path in args, and pass only the external token path in env:
mcp_servers:
google-contacts:
command: node
args: [/absolute/path/to/google-contacts-mcp/index.js]
env:
GOOGLE_CONTACTS_TOKEN_PATH: /absolute/path/outside-this-repo/google_token.jsonRestart Hermes after adding the server so it can discover the tools.
Development
npm testThe tests never contact Google and do not require a token.
License
MIT.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
A MCP server that works with Google Calendar to manage event listing, reading, and updates.
Unofficial remote MCP server for Less Annoying CRM: OAuth 2.1, read-only grants, 10 tools.
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
Streamable HTTP MCP server for Google Calendar and Sheets with OAuth login.
Related MCP Servers
- AlicenseAqualityDmaintenanceA Machine Conversation Protocol server that enables AI assistants to manage Google Contacts and search Google Workspace directories, providing tools for listing, creating, updating, and deleting contacts within your Google account.933MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server that integrates Google Contacts with Claude, enabling contact management directly from your AI assistant.MIT
- AlicenseNot gradedqualityBmaintenanceMCP server for Google Contacts - list, search, and manage contacts.101 npm6MIT
- AlicenseNot gradedqualityCmaintenanceA local-first contact management MCP server with SQLite storage and Google Contacts sync, enabling AI agents to upsert, search, log interactions, and surface follow-ups for relationships.123 npmMIT