Google Contacts
A Machine Conversation Protocol server that enables AI assistants to manage Google Contacts and search Google Workspace directories, providing tools for listing, creating, updating, and deleting contacts within your Google account.
What is Google Contacts?
Google Contacts is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to machine conversation protocol server that enables ai assistants to manage google contacts and search google workspace directories, providing tools for listing, creating, updating, and deleting contact...
A Machine Conversation Protocol server that enables AI assistants to manage Google Contacts and search Google Workspace directories, providing tools for listing, creating, updating, and deleting contacts within your Google account.
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Machine Conversation Protocol server that enables AI assis
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-google-contacts-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Google Contacts
The MCP Google Contacts server enables AI assistants to manage personal Google Contacts and search Google Workspace organization directories through a standardized MCP interface. It provides nine tools covering the full contacts lifecycle — listing, searching, creating, updating, and deleting contacts — as well as querying Google Workspace user directories. It uses OAuth 2.0 for secure authentication, making it suitable for both personal Gmail accounts and corporate Google Workspace environments.
Prerequisites
- Python 3.8 or higher installed
- A Google Cloud project with the People API enabled
- OAuth 2.0 credentials (GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET) from Google Cloud Console
- A valid GOOGLE_REFRESH_TOKEN obtained through the OAuth authorization flow
- An MCP-compatible client such as Claude Desktop or Cursor
Enable the Google People API
Go to Google Cloud Console, create or select a project, enable the Google People API, and create OAuth 2.0 credentials (Desktop App type). Download the client ID and secret.
Clone the repository and install
Clone the repository, rename the source directory, and install the package.
git clone https://github.com/RayanZaki/mcp-google-contacts-server.git
cd mcp-google-contacts-server
mv src mcp_google_contacts_server
pip install .Obtain a refresh token
Run the OAuth authorization flow to get a refresh token. Use a tool like oauth2l or the Google OAuth Playground, or run the server once with --client-id and --client-secret to trigger the browser-based auth flow and capture the refresh token.
mcp-google-contacts --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRETConfigure Claude Desktop
Add the server to your Claude Desktop config with your OAuth credentials as environment variables.
{
"mcpServers": {
"google-contacts": {
"command": "mcp-google-contacts",
"args": [],
"env": {
"GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
"GOOGLE_CLIENT_SECRET": "your-client-secret",
"GOOGLE_REFRESH_TOKEN": "your-refresh-token"
}
}
}
}Restart Claude Desktop and verify
Restart Claude Desktop. Ask Claude to list your Google contacts to confirm the server has authenticated successfully.
Google Contacts Examples
Client configuration
Claude Desktop configuration for the Google Contacts MCP server using OAuth credentials as environment variables.
{
"mcpServers": {
"google-contacts": {
"command": "mcp-google-contacts",
"args": [],
"env": {
"GOOGLE_CLIENT_ID": "YOUR_CLIENT_ID.apps.googleusercontent.com",
"GOOGLE_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
"GOOGLE_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN"
}
}
}
}Prompts to try
Contact management tasks Claude can perform using the Google Contacts MCP server.
- "List all my Google contacts whose name starts with John"
- "Find the email address and phone number for Jane Smith in my contacts"
- "Create a new contact: Sarah Johnson, [email protected], +1-555-0123"
- "Update the phone number for contact [email protected] to +1-555-9999"
- "Search the Google Workspace directory for people in the engineering department"
- "Delete the contact with email [email protected] from my Google account"Troubleshooting Google Contacts
OAuth token expired or invalid refresh token errors
Refresh tokens can expire if unused for 6 months or if the Google Cloud project's consent screen is in 'Testing' mode (7-day expiry). Re-run the OAuth flow to get a new refresh token, or publish your OAuth consent screen in Google Cloud Console to get long-lived tokens.
People API not enabled or insufficient permission errors
Go to Google Cloud Console → APIs & Services → Library and enable the 'Google People API'. Also verify your OAuth scope includes 'https://www.googleapis.com/auth/contacts' for full read/write access to contacts.
mcp-google-contacts command not found after pip install
Ensure the Python scripts directory is in your PATH. On macOS/Linux, try running with the full path (e.g., ~/.local/bin/mcp-google-contacts) or use 'python -m mcp_google_contacts_server' instead and adjust the command in your config accordingly.
Frequently Asked Questions about Google Contacts
What is Google Contacts?
Google Contacts is a Model Context Protocol (MCP) server that machine conversation protocol server that enables ai assistants to manage google contacts and search google workspace directories, providing tools for listing, creating, updating, and deleting contacts within your google account. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Google Contacts?
Follow the installation instructions on the Google Contacts GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Google Contacts?
Google Contacts works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Google Contacts free to use?
Yes, Google Contacts is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Google Contacts Alternatives — Similar Communication Servers
Looking for alternatives to Google Contacts? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Google Contacts in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Google Contacts?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.