MewCP Google People MCP

from AStheTECH

Hosted, Stateless & Multitenant Google People MCP server enables AI assistants to access, manage, and organize contacts and profile information through Google People API.

🔥🔥🔥✓ VerifiedFreeQuick setup

#email #automation

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

get_person — Get a person from Google Contacts

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")

Output:

{
  "resourceName": "people/c12345",
  "names": [{ "displayName": "Jane Doe" }],
  "emailAddresses": [{ "value": "jane@example.com" }]
}

list_connections — List connections from Google Contacts

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": [{ "resourceName": "people/c12345", "names": [...] }],
  "nextPageToken": "...",
  "totalItems": 42
}

create_contact — Create a contact in Google Contacts

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",
  "names": [{ "displayName": "Jane Doe" }]
}

update_contact — Update a contact in Google Contacts

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

Output:

{
  "resourceName": "people/c12345",
  "names": [{ "displayName": "Jane Smith" }]
}

delete_contact — Delete a contact from Google Contacts

Permanently deletes a contact by resource name.

Inputs:

- `resource_name`  (string, required) — Resource name of the contact to delete (e.g. "people/c12345")

Output:

{}

search_contacts — Search for contacts in Google Contacts

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")

Output:

{
  "results": [
    { "person": { "resourceName": "people/c12345", "names": [...] } }
  ]
}

list_contact_groups — List contact groups in Google Contacts

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

Output:

{
  "contactGroups": [{ "resourceName": "contactGroups/myContacts", "name": "myContacts" }],
  "nextPageToken": "..."
}

get_contact_group — Get a contact group from Google Contacts

Fetches a single contact group by resource name.

Inputs:

- `resource_name`  (string, required) — Resource name of the contact group (e.g. "contactGroups/abc123")

Output:

{
  "resourceName": "contactGroups/abc123",
  "name": "Coworkers",
  "memberCount": 5
}

create_contact_group — Create a contact group in Google Contacts

Creates a new contact group from a JSON contact group object.

Inputs:

- `contact_group`  (string, required) — JSON string representing the group to create (e.g. '{"contactGroup":{"name":"Team"}}')

Output:

{
  "resourceName": "contactGroups/abc123",
  "name": "Team"
}

update_contact_group — Update a contact group in Google Contacts

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

Output:

{
  "resourceName": "contactGroups/abc123",
  "name": "Updated Team"
}

delete_contact_group — Delete a contact group from Google Contacts

Permanently deletes a contact group by resource name.

Inputs:

- `resource_name`  (string, required) — Resource name of the group to delete (e.g. "contactGroups/abc123")

Output:

{}

batch_get_contact_groups — Get multiple contact groups at once

Fetches details for multiple contact groups in a single request.

Inputs:

- `resource_names`  (string, required) — Comma-separated list of contact group resource names (e.g. "contactGroups/abc,contactGroups/def")

Output:

{
  "responses": [
    { "contactGroup": { "resourceName": "contactGroups/abc", "name": "Team" } }
  ]
}

list_other_contacts — List other contacts in Google Contacts

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

Output:

{
  "otherContacts": [{ "resourceName": "otherContacts/c99999", "names": [...] }],
  "nextPageToken": "..."
}

search_other_contacts — Search other contacts in Google Contacts

Searches the "Other Contacts" list using a text query.

Inputs:

- `query`      (string, required) — Text to search for
- `read_mask`  (string, required) — Comma-separated list of fields to return in results

Output:

{
  "results": [
    { "person": { "resourceName": "otherContacts/c99999", "names": [...] } }
  ]
}

copy_other_contact_to_my_contacts_group — Copy an other contact to My Contacts

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")

Output:

{
  "resourceName": "people/c12345",
  "names": [{ "displayName": "Jane Doe" }]
}

API Parameters Reference

Common Parameters

resource_name — Identifies a specific person or group. Formats:
- "people/me" — the authenticated user
- "people/c{id}" — a specific contact
- "contactGroups/{id}" — a contact group
- "otherContacts/c{id}" — an other contact
page_size — Caps the number of items returned per request. If omitted the API applies its own default limit.
page_token — Opaque token returned in a previous response's nextPageToken field. Pass it to retrieve the next page of results.

Field Mask Formats

person_fields / read_mask — comma-separated, no spaces:

names,emailAddresses,phoneNumbers,addresses,organizations,birthdays,photos

update_person_fields — must list every field you are changing:

names,emailAddresses

copy_mask — fields to carry over when promoting an other contact:

names,emailAddresses,phoneNumbers

Person JSON structure example:

{
  "names": [{ "givenName": "Jane", "familyName": "Doe" }],
  "emailAddresses": [{ "value": "jane@example.com" }],
  "phoneNumbers": [{ "value": "+1-555-0100" }]
}

Overview

Tools

API Parameters Reference

Troubleshooting