MCP Google Contacts Server logo

MCP Google Contacts Server

by RayanZaki

The MCP Google Contacts Server provides Google Contacts functionality for AI assistants. It allows managing contacts, searching organization directories, and interacting with Google Workspace.

View on GitHub

Last updated: N/A

What is MCP Google Contacts Server?

This is a Machine Conversation Protocol (MCP) server that acts as an interface between AI clients and Google Contacts/Workspace. It enables AI assistants to access and manipulate contact data.

How to use MCP Google Contacts Server?

First, install the server and configure Google API credentials. Then, start the server using the command line, specifying the desired transport protocol (stdio or http) and any necessary arguments. Finally, integrate the server into your MCP client configuration.

Key features of MCP Google Contacts Server

  • List and search Google Contacts

  • Create, update, and delete contacts

  • Search Google Workspace directory

  • View 'Other Contacts'

  • Access Google Workspace users

Use cases of MCP Google Contacts Server

  • Allow AI assistants to manage personal or organizational contacts

  • Enable AI agents to search for colleagues in a company directory

  • Automate contact creation and updates based on user interactions

  • Integrate contact information into AI-powered workflows

FAQ from MCP Google Contacts Server

How do I authenticate with Google?

You can use either a credentials.json file or set environment variables for your Google OAuth client ID, client secret, and refresh token.

What is the default transport protocol?

The default transport protocol is stdio.

How do I start the server with HTTP transport?

Use the command: python src/main.py --transport http --port 8080

What permissions are required?

The server requires permissions to access your Google Contacts and possibly your Google Workspace directory.

What if I encounter authentication issues?

Ensure your credentials are valid, have the necessary scopes, and that you have enabled the People API in your Google Cloud project.

MCP Google Contacts Server - MCP Server | MCP Directory