Google ContactsSAFE
A Google Contacts server using MCP
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
[](https://mseep.ai/app/rayanzaki-mcp-google-contacts-server)
A Machine Conversation Protocol (MCP) server that provides Google Contacts functionality, allowing AI assistants to manage contacts, search your organization's directory, and interact with Google Workspace. Much updated from its original by Gemini AI in Gemini CLI.
✨ Features
- List and search Google Contacts
- Create, update, and delete contacts
- Search Google Workspace directory
- View "Other Contacts" (people you've interacted with but haven't added)
- Access Google Workspace users in your organization
🚀 Installation
📋 Prerequisites
- Python 3.12 or higher
- Google account with contacts access
- Google Cloud project with People API enabled
- OAuth 2.0 credentials for Google API access
📦 Installation from Source
To install the mcp-google-contacts-server as a Python package:
- Clone the repository:
git clone https://github.com/rayanzaki/mcp-google-contacts-server.git cd mcp-google-contacts-server
- Rename the source directory:
The package expects the source code to be in a directory named mcp_google_contacts_server.
mv src mcp_google_contacts_server
- Install the package:
This will install the package and its dependencies, making the mcp-google-contacts command available in your PATH.
pip install .
Note: If you encounter import errors after installation, ensure that relative imports within the source files (`main.py`, `tools.py`, `google_contacts_service.py`, `formatters.py`, `config.py`) are updated to use absolute imports (e.g., `from mcp_google_contacts_server.module_name import ...`). This is typically handled automatically by `pip install .` but can sometimes require manual adjustment if the package structure is unusual.
##
60ab20cd539eOBSERVED · 2026-10-08Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add mcp-google-contacts-server --env GOOGLE_CLIENT_SECRET=${GOOGLE_CLIENT_SECRET} --env GOOGLE_REFRESH_TOKEN=${GOOGLE_REFRESH_TOKEN} -- uvx mcp-google-contacts-server{
"mcpServers": {
"mcp-google-contacts-server": {
"command": "uvx",
"args": [
"mcp-google-contacts-server"
],
"env": {
"GOOGLE_CLIENT_SECRET": "${GOOGLE_CLIENT_SECRET}",
"GOOGLE_REFRESH_TOKEN": "${GOOGLE_REFRESH_TOKEN}"
}
}
}
}Exposed tools (9)
6 read · 2 write · 1 destructive. Blast radius: 1 tool can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.
| Tool | Risk | Description |
|---|---|---|
create_contact | write | Create a new contact. |
delete_contact | destructive | Delete a contact by resource name. |
get_contact | read | Get a contact by resource name or email. |
get_other_contacts | read | Retrieve contacts from the |
list_contacts | read | List all contacts or filter by name. |
list_workspace_users | read | List Google Workspace users in your organization |
search_contacts | read | Search contacts by name, email, or phone number. |
search_directory | read | Search for people specifically in the Google Workspace directory. |
update_contact | write | Update an existing contact. |
Trust audit
SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | WARN |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (1 observation(s))
- Network
- none-observed
- Shell
- none-observed
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (2)
delete_contact
mcp, google-auth, google-api-python-client, google-auth-httplib2, google-auth-oauthlib, google-auth, httpx, pydantic
Gates applied: no_behavioural_pass.
60ab20cd539efull audit observations/trust-audit/mcp-server/rayanzaki__google-contacts.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-08 | 60ab20cd539e | SAFE | B | 89 | first audit |
Questions
What is the Google Contacts MCP server?
A Google Contacts server using MCP
What tools does Google Contacts expose?
9 in total: 6 read-only, 2 that write, and 1 that can delete or overwrite (delete_contact). Every one is listed on this page with its risk.
Is Google Contacts safe to connect to an agent?
The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B. Separately from the audit: 1 of its tools can destroy data, so scope the token you give it to what you actually need.
What credentials does Google Contacts need?
It reads GOOGLE_CLIENT_SECRET and GOOGLE_REFRESH_TOKEN from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does Google Contacts run?
It speaks stdio, so it runs as a local process your client starts. It is published on PyPI as mcp-google-contacts-server.
How current is this page?
The grade is for one exact copy of the source (60ab20cd539e), read on 2026-10-08. The repository is watched and re-audited when it changes.