What prerequisites are needed to run MCP Google Contacts Server?
You need Python 3.12 or higher, a Google account with contacts access, a Google Cloud project with the People API enabled, and OAuth 2.0 credentials for Google API access.
MCP Google Contacts Server
@RayanZaki
Basic information
About MCP Google Contacts Server
A Google Contacts server using MCP
MCP Google Contacts Server config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"mcp-google-contacts-server": {
"command": "uv",
"args": [
"venv"
]
}
}
}MCP Google Contacts Server tools
Tool list not available yet
This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is MCP Google Contacts Server?
MCP Google Contacts Server is 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.
How to use MCP Google Contacts Server?
Install the Python package from source (pip install . after cloning and renaming the source directory), authenticate with Google (using a credentials.json file or environment variables), and run the server with mcp-google-contacts or python src/main.py. Integrate with MCP clients by adding its configuration to your MCP settings.
Key features of MCP Google Contacts Server
- List, search, create, update, and delete Google Contacts
- Search Google Workspace directory for users
- View "Other Contacts" (people you've interacted with)
- Access Google Workspace users in your organization
- Supports stdio and HTTP transport protocols
- Configurable via command-line arguments and environment variables
Use cases of MCP Google Contacts Server
- AI assistants managing personal or shared contact lists
- Searching your organization's directory for colleagues
- Cleaning up or updating existing contacts programmatically
- Integrating contact management into automated workflows
- Discovering and interacting with people from email history
Frequently asked questions
How do I authenticate MCP Google Contacts Server with Google?
You can use a `credentials.json` file placed in the project root, home directory, or specified via `--credentials-file`. Alternatively, set `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`, and `GOOGLE_REFRESH_TOKEN` environment variables.
How do I install MCP Google Contacts Server from source?
Clone the repository, rename the `src` directory to `mcp_google_contacts_server`, then run `pip install .` to install the package and make the `mcp-google-contacts` command available.
How can I integrate MCP Google Contacts Server with MCP clients?
Add the server to your MCP client’s configuration (e.g., for Claude with Cline) using the `uv run main.py` command and specifying the directory path.
What tools does MCP Google Contacts Server provide?
It offers nine tools: `list_contacts`, `get_contact`, `create_contact`, `update_contact`, `delete_contact`, `search_contacts`, `list_workspace_users`, `search_directory`, and `get_other_contacts`.
More Other MCP servers
Awesome Mlops
visengerA curated list of references for MLOps
14.0K
Hindsight
vectorize-ioHindsight: Agent Memory That Learns
50.4K
Yuppsy
Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code
EverArt
modelcontextprotocolModel Context Protocol Servers
88.1K
The Living Bread
The Living BreadA free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w
Comments