io.github.domdomegg/google-contacts-mcp

Get detailed information about a single contact by resource name.

List contacts from the user\'s Google Contacts. Returns names, emails, phone numbers, organizations, birthdays, events, URLs, addresses, nicknames, relations, IM usernames, genders, external IDs, client data, and custom fields.

Rename an existing contact group. Use contact_group_get first to retrieve the current etag. System groups (e.g. "My Contacts", "Starred") cannot be renamed.

Set (or replace) the photo for a contact. Provide the image as base64-encoded JPEG or PNG bytes.

Create a new contact group (label) in Google Contacts.

Add or remove contacts from a contact group. Use this to manage which contacts belong to a group/label. This is the only way to change group membership - the People API does not support editing it via contact_update.

List contact groups (labels) from the user\'s Google Contacts, including system groups like "My Contacts" and "Starred".

Update an existing contact. Use contact_get first to retrieve the current etag.

Remove the photo from a contact, reverting to the default avatar.

Permanently delete a contact from Google Contacts.

Get detailed information about a single contact group, including its member resource names.

Permanently delete a contact group. System groups (e.g. "My Contacts", "Starred") cannot be deleted. By default this only removes the group/label; pass deleteContacts=true to also delete the member contacts.

Search for contacts by name, email, or phone number.

Create a new contact in Google Contacts.

Search the organization directory for people (coworkers, etc). Requires directory.readonly scope.