Is this the old Contacts API or the People API?

The People API — Google’s current interface for contact data. The legacy Contacts API was shut down; this service was built on People from the start.

Can it import a batch of contacts at once?

manage_contacts_batch creates, updates, or deletes many contacts in a single call, so importing a hiring class from a spreadsheet does not mean one round trip per person.

How does group membership work?

manage_contact_group handles the full group lifecycle including adding and removing members, and get_contact_group returns a group’s current membership so the assistant can diff before changing anything.

Google Contacts MCP Server

People API contact and group management, including batch operations.

$ uvx workspace-mcp --tools contacts runs only the Google Contacts MCP tools — combine services as needed

Quick start Full API reference →

Built on Google’s People API, the Contacts service handles both individual records and bulk work. search_contacts matches on name, email, or phone; manage_contact covers single-record create, update, and delete; and manage_contacts_batch applies the same operations across many records in one call.

Group support is first-class rather than bolted on — list, inspect, create, and modify contact groups, and manage membership, which is what most real organizing tasks actually need.

What you can ask

“Find everyone with an acme.com address in my contacts and add them to the Partners group”
“Create contacts for these five new hires from the onboarding sheet”
“Update Priya’s phone number and move her to the Leadership group”

All 8 Google Contacts MCP tools

Tiers control how many tools the server registers: start lean with --tool-tier core and step up to extended or complete when a workflow needs more. Parameters and examples for every tool are in the API reference.

search_contacts Core Search by name, email, and phone.

get_contact Core Retrieve detailed contact profiles.

list_contacts Core List contacts with pagination.

manage_contact Core Create, update, or delete contacts.

list_contact_groups Extended List contact groups.

get_contact_group Extended Retrieve group details and members.

manage_contacts_batch Complete Batch create, update, or delete contacts.

manage_contact_group Complete Create, update, delete groups, and manage membership.

OAuth scopes

The server requests only the scopes for the services you enable. In read-only mode it requests just the readonly variants and skips registering write tools entirely.

contacts.readonly search and read contacts and groups
contacts create, update, and delete contacts and groups

Google Contacts MCP questions

Is this the old Contacts API or the People API?: The People API — Google’s current interface for contact data. The legacy Contacts API was shut down; this service was built on People from the start.
Can it import a batch of contacts at once?: manage_contacts_batch creates, updates, or deletes many contacts in a single call, so importing a hiring class from a spreadsheet does not mean one round trip per person.
How does group membership work?: manage_contact_group handles the full group lifecycle including adding and removing members, and get_contact_group returns a group’s current membership so the assistant can diff before changing anything.

Works alongside

All services: Gmail MCP·Google Drive MCP·Google Calendar MCP·Google Docs MCP·Google Sheets MCP·Google Slides MCP·Google Forms MCP·Google Tasks MCP·Google Contacts MCP·Google Chat MCP·Google Custom Search MCP·Google Apps Script MCP