Google Contacts MCP server
{
"mcpServers": {
"a1-x-tech-google-contacts": {
"command": "npx",
"args": [
"-y",
"mcp-google-contacts@latest"
],
"env": {
"GOOGLE_CONTACTS_CLIENT_ID": "<google_contacts_client_id>",
"GOOGLE_CONTACTS_CLIENT_SECRET": "<google_contacts_client_secret>",
"GOOGLE_CONTACTS_REFRESH_TOKEN": "<google_contacts_refresh_token>",
"GOOGLE_CONTACTS_ACCESS_TOKEN": "<google_contacts_access_token>"
}
}
}
}{
"mcpServers": {
"a1-x-tech-google-contacts": {
"command": "npx",
"args": [
"-y",
"mcp-google-contacts@latest"
],
"env": {
"GOOGLE_CONTACTS_CLIENT_ID": "<google_contacts_client_id>",
"GOOGLE_CONTACTS_CLIENT_SECRET": "<google_contacts_client_secret>",
"GOOGLE_CONTACTS_REFRESH_TOKEN": "<google_contacts_refresh_token>",
"GOOGLE_CONTACTS_ACCESS_TOKEN": "<google_contacts_access_token>"
}
}
}
}{
"mcpServers": {
"a1-x-tech-google-contacts": {
"command": "npx",
"args": [
"-y",
"mcp-google-contacts@latest"
],
"env": {
"GOOGLE_CONTACTS_CLIENT_ID": "<google_contacts_client_id>",
"GOOGLE_CONTACTS_CLIENT_SECRET": "<google_contacts_client_secret>",
"GOOGLE_CONTACTS_REFRESH_TOKEN": "<google_contacts_refresh_token>",
"GOOGLE_CONTACTS_ACCESS_TOKEN": "<google_contacts_access_token>"
}
}
}
}{
"servers": {
"a1-x-tech-google-contacts": {
"command": "npx",
"args": [
"-y",
"mcp-google-contacts@latest"
],
"env": {
"GOOGLE_CONTACTS_CLIENT_ID": "${input:google_contacts_client_id}",
"GOOGLE_CONTACTS_CLIENT_SECRET": "${input:google_contacts_client_secret}",
"GOOGLE_CONTACTS_REFRESH_TOKEN": "${input:google_contacts_refresh_token}",
"GOOGLE_CONTACTS_ACCESS_TOKEN": "${input:google_contacts_access_token}"
}
}
},
"inputs": [
{
"id": "google_contacts_client_id",
"type": "promptString",
"description": "Google contacts client id",
"password": true
},
{
"id": "google_contacts_client_secret",
"type": "promptString",
"description": "Google contacts client secret",
"password": true
},
{
"id": "google_contacts_refresh_token",
"type": "promptString",
"description": "Google contacts refresh token",
"password": true
},
{
"id": "google_contacts_access_token",
"type": "promptString",
"description": "Google contacts access token",
"password": true
}
]
}{
"mcpServers": {
"a1-x-tech-google-contacts": {
"command": "npx",
"args": [
"-y",
"mcp-google-contacts@latest"
],
"env": {
"GOOGLE_CONTACTS_CLIENT_ID": "<google_contacts_client_id>",
"GOOGLE_CONTACTS_CLIENT_SECRET": "<google_contacts_client_secret>",
"GOOGLE_CONTACTS_REFRESH_TOKEN": "<google_contacts_refresh_token>",
"GOOGLE_CONTACTS_ACCESS_TOKEN": "<google_contacts_access_token>"
}
}
}
}file .mcp.json (in your project root)file claude_desktop_config.jsonfile ~/.cursor/mcp.jsonfile .vscode/mcp.jsonfile ~/.codeium/windsurf/mcp_config.jsoninstall npx -y mcp-google-contactsversion 0.1.0
What it does
An MCP server that connects to Google Contacts via the People API, allowing you to search, create, update and delete contacts and groups. It is for developers building AI applications that need to programmatically manage contact information with concurrency safeguards and minimal Google API permissions.
- Find contacts by name or organization and retrieve their email addresses and phone numbers.
- Create new contacts or update existing ones with new phone numbers, emails, or other details.
- Organize contacts by adding them to labels or groups and manage group membership.
Tools this server exposes
| Tool | Does |
|---|---|
| list_contacts | List all contacts with optional field filtering. |
| search_contacts | Search for contacts by name or other criteria. |
| get_contact | Retrieve full details for a single contact. |
| create_contact | Create a new contact with specified fields. |
| update_contact | Update an existing contact with etag-guarded writes to prevent concurrent edit conflicts. |
| delete_contact | Permanently delete a contact. |
| list_groups | List all contact groups. |
| get_group | Retrieve details for a single group. |
| create_group | Create a new contact group. |
| update_group | Update an existing group. |
| delete_group | Permanently delete a group. |
| add_contact_to_group | Add a contact to a group. |
| remove_contact_from_group | Remove a contact from a group. |
| list_other_contacts | List contacts from the auto-saved 'Other contacts' section. |
| get_other_contact | Retrieve a contact from 'Other contacts'. |
| copy_other_contact | Move a contact from 'Other contacts' to regular contacts. |
Before you enable it
An MCP server runs with whatever access you give it. Start with a development account rather than production, and check which tools the server exposes before you let an agent call them unattended.