Tools

List Contacts

Lists the authenticated user's contacts with pagination support. Returns contacts sorted by the specified order. Use the `pageToken` from a previous response to fetch the next page.

Delete Contact

Permanently deletes a contact from the authenticated user's Google Contacts. This action cannot be undone.

Create Contact

Creates a new contact in the authenticated user's Google Contacts. Provide any combination of names, emails, phone numbers, addresses, organizations, and other contact fields.

Create Contact Group

Creates a new contact group (label) for the authenticated user. Group names must be unique among the user's contact groups. Optionally attach client-specific key-value data.

Update Contact Group

Updates the name or client data of an existing user-defined contact group. System contact groups cannot be renamed.

Get Contact

Retrieves detailed information about a specific contact by their resource name. Use `people/me` to get the authenticated user's profile. Returns all available contact fields.

Modify Group Members

Add or remove contacts from a contact group. You can add contacts to `contactGroups/myContacts` and `contactGroups/starred`, and to any user-defined group. Provide contact resource names to add and/or remove in a single operation.

List Other Contacts

Lists contacts automatically saved in "Other contacts" by Google from interactions. These are read-only and only include names, email addresses, and phone numbers. Requires the `contacts.other.readonly` scope.

Search Contacts

Searches the authenticated user's contacts by name, email address, phone number, or other fields. Returns matching contacts ranked by relevance.

Search Directory

Searches the Google Workspace domain directory for profiles and contacts matching a query. Only available for Google Workspace users with the `directory.readonly` scope. The domain admin must have enabled external contact and profile sharing.

Get Contact Group

Retrieves details about a specific contact group including its name, type, member count, and member resource names. Use this to inspect group membership.

Delete Contact Group

Deletes a user-defined contact group. Optionally also deletes the contacts that are members of the group. System contact groups cannot be deleted.

List Contact Groups

Lists all contact groups (labels) owned by the authenticated user, including both user-defined and system groups (like "My Contacts" and "Starred").

Update Contact

Updates an existing contact's data. You must provide the contact's resource name and etag (obtained from a previous get/list/search). Only the fields you include will be updated; omitted fields remain unchanged.

Copy Other Contact to My Contacts

Copies an "Other contact" to the user's "My Contacts" group, making it a regular editable contact. Requires both the `contacts.other.readonly` and `contacts` scopes.

Search Other Contacts

Searches "Other contacts" by name, email, or phone number. Other contacts are automatically saved by Google from interactions and are read-only. Requires the `contacts.other.readonly` scope.