Google Contacts MCP capabilities

This catalog contains 19 public pages—one for every registered MCP tool in mcp-google-contacts. Each page starts with the user's task, explains the result, and states whether the call changes real data.

Use this catalog to choose a ready-made capability. Full parameter schemas and API response details remain in the technical reference.

Contacts

List contacts — Lists the user's saved contacts with pagination, sorting and incremental-sync tokens. Impact: read-only.
Search contacts — Full-text prefix search over saved contacts by names, emails, phones and organizations. Impact: read-only.
Get a contact — Fetches one person by resource name with an explicit field mask. Impact: read-only.
Get many contacts at once — Fetches up to 200 people in a single request. Impact: read-only.
Create a contact — Creates one new contact from normalized fields. Impact: changes data.
Update a contact — Replaces chosen field groups on an existing contact, etag-guarded. Impact: destructive operation.
Delete a contact — Permanently deletes one contact. Impact: destructive operation.

Contact groups

List contact groups — Lists system and user-created groups (labels). Impact: read-only.
Get a contact group — One group, optionally with member resource names. Impact: read-only.
Create a contact group — Creates a new user group (label). Impact: changes data.
Rename a contact group — Renames a user-created group, etag-guarded. Impact: destructive operation.
Delete a contact group — Deletes a user group; optionally its member contacts too. Impact: destructive operation.
Add/remove group members — Changes which contacts carry a label, in one call. Impact: destructive operation.

Batch operations

Create many contacts — Up to 200 contacts in one atomic request. Impact: changes data.
Update many contacts — Up to 200 updates with a shared update mask, atomic. Impact: destructive operation.
Delete many contacts — Up to 500 permanent deletes, atomic. Impact: destructive operation.

Other contacts

List or search Other contacts — Auto-saved addresses outside the saved list. Impact: read-only.
Copy an Other contact into My Contacts — Turns an auto-saved address into a real contact. Impact: changes data.

Additional API methods

Raw Google People API call — Escape hatch for endpoints the typed tools don't cover. Impact: destructive operation.