📇 MCP Google Contacts Server

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.