📇 MCP Google Contacts Server

Name: 📇 MCP Google Contacts Server
Author: RayanZaki

@RayanZaki

Repository

About 📇 MCP Google Contacts Server

A Google Contacts server using MCP

#mcp #google-contacts #server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-google-contacts-server": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Tools

No tools detected

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

FAQ from MCP Google Contacts Server

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.

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.