Search, manage, and organize your Google Contacts with AI.
A Model Context Protocol (MCP) server that exposes Google People API for reading, creating, updating, and deleting contacts and contact groups.
Overview
The Google People MCP Server provides full Google Contacts management capabilities:
Create, read, update, delete, and search personal contacts
Manage contact groups — list, create, update, or delete them
Access and promote "Other Contacts" auto-saved by Google services
Perfect for:
Looking up contact details and email addresses via AI assistants
Automating contact list maintenance and group organization
Copying frequently-interacted contacts from "Other Contacts" into your main list
Tools
Fetches a contact by resource name, returning only the fields specified.
Inputs:
- `resource_name` (string, required) — Resource name of the person (e.g. "people/me" or "people/c12345")- `person_fields` (string, required) — Comma-separated list of fields to return (e.g. "names,emailAddresses,phoneNumbers")
Returns a paginated list of the authenticated user's contacts.
Inputs:
- `resource_name` (string, required) — Resource name of the person to list connections for (use "people/me" for the authenticated user)- `person_fields` (string, required) — Comma-separated list of fields to return (e.g. "names,emailAddresses")- `page_size` (integer, optional) — Maximum number of connections to return- `page_token` (string, optional) — Page token from a previous list request for pagination
output:
{ "connections": [{
Creates a new contact from a JSON person object.
Inputs:
- `person` (string, required) — JSON string representing the person to create (e.g. '{"names":[{"givenName":"Jane","familyName":"Doe"}],"emailAddresses":[{"value":"jane@example.com"}]}')
output:
{ "resourceName": "people/c12345"
Updates specific fields of an existing contact.
Inputs:
- `resource_name` (string, required) — Resource name of the contact to update (e.g. "people/c12345")- `update_person_fields` (string, required) — Comma-separated list of fields being updated (e.g. "names,emailAddresses")- `person` (string, required) — JSON string with the updated person data
- `resource_name` (string, required) — Resource name of the contact to delete (e.g. "people/c12345")
output:
{}
Searches across the user's contacts using a text query.
Inputs:
- `query` (string, required) — Text to search for (matches names, emails, phone numbers, etc.)- `read_mask` (string, required) — Comma-separated list of fields to return in results (e.g. "names,emailAddresses")
Returns all contact groups belonging to the authenticated user.
Inputs:
- `page_size` (integer, optional) — Maximum number of groups to return- `page_token` (string, optional) — Page token from a previous list request for pagination
Updates the name or metadata of an existing contact group.
Inputs:
- `resource_name` (string, required) — Resource name of the group to update (e.g. "contactGroups/abc123")- `contact_group` (string, required) — JSON string with the updated contact group data
Returns "Other Contacts" — people automatically saved by Google from interactions (emails, calls, etc.).
Inputs:
- `read_mask` (string, required) — Comma-separated list of fields to return (e.g. "names,emailAddresses")- `page_size` (integer, optional) — Maximum number of contacts to return- `page_token` (string, optional) — Page token from a previous list request for pagination
Promotes a contact from "Other Contacts" into the user's main "My Contacts" group.
Inputs:
- `resource_name` (string, required) — Resource name of the other contact to copy (e.g. "otherContacts/c99999")- `copy_mask` (string, required) — Comma-separated list of fields to copy (e.g. "names,emailAddresses,phoneNumbers")
