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.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Google Contacts MCP search for contacts named Smith"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A small, local Model Context Protocol server for Google Contacts (Google People API).
This repository intentionally contains no credentials and does not implement OAuth login or redirects.
Set GOOGLE_CONTACTS_TOKEN_PATH to 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.
.gitignore rejects token, secret and credential JSON files.
On each refresh, the token file is written with Unix permission 0600.
Write operations require confirm: true in 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-workspace-mcp-server
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.
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.
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.
npm testThe tests never contact Google and do not require a token.
MIT.
This server cannot be deployed
A MCP server that works with Google Calendar to manage event listing, reading, and updates.
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.
The Google Compute Engine MCP server is a fully-managed Model Context Protocol server that provides tools to manage Google Compute Engine resources through AI agents. It enables capabilities including instance management (creating, starting, stopping, resetting, listing), disk management, handling instance templates and group managers, viewing machine and accelerator types, managing images, and accessing reservation and commitment information. The server operates as a zero-deployment, enterprise-grade endpoint at https://compute.googleapis.com/mcp with built-in IAM-based security.
