> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Contacts

> Connect Google Contacts to your Atako agents — 5 read and 5 write actions.

Let your agents list, search, create, update and delete Google Contacts, and manage contact groups.

## Connection

* **Authentication**: OAuth 2.0 — you authorize Atako via Google Contacts's consent screen; no key to copy.
* **Scopes requested**:
  * `https://www.googleapis.com/auth/contacts`

See [Google Contacts's documentation](https://developers.google.com/people/api/rest/v1/people.connections/list).

## Read actions (5)

| Action                | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `get_contact`         | Get a single contact by its resource name (e.g. "people/12345" from list\_contacts). personFields (string, optional): comma-separated field mask to restrict returned fields.                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `get_contact_group`   | Get a contact group by its resource name (e.g. "contactGroups/abc123" from list\_contact\_groups). maxMembers (integer, optional): max members to return (default 0).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `list_contact_groups` | List all contact groups. pageSize (integer, optional, 1–1000, default 30): max groups per page. pageToken (string, optional): token for next page.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `list_contacts`       | List contacts from the connected Google account. personFields (string, default "names,emailAddresses,phoneNumbers,organizations"): comma-separated field mask — valid values: names, emailAddresses, phoneNumbers, organizations, addresses, biographies, birthdays, events, genders, locales, memberships, metadata, nicknames, occupations, photos, relations, urls, userDefined. pageSize (integer, optional, 1–1000, default 100): max contacts per page. pageToken (string, optional): token for next page. sortOrder (string, optional): one of LAST\_MODIFIED\_ASCENDING, LAST\_MODIFIED\_DESCENDING, FIRST\_NAME\_ASCENDING, LAST\_NAME\_ASCENDING. |
| `search_contacts`     | Search contacts by name or email. query (string, required): plain-text query, matches prefix of name/email fields. readMask (string, required): comma-separated field mask (e.g. "names,emailAddresses"). pageSize (integer, optional, 1–30, default 10): max results. Note: first call may be slow (warmup).                                                                                                                                                                                                                                                                                                                                               |

## Write actions (5)

| Action                       | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `add_contacts_to_group`      | Add contacts to a contact group. resourceName (string, required): the group resource name (e.g. "contactGroups/abc123"). resourceNamesToAdd (array of strings, required): contact resource names to add (e.g. \["people/12345"]).                                                                                                                                                                                                                                                                                                                   |
| `create_contact`             | Create a new contact. given\_name (string): first name. family\_name (string): last name. emails (array of strings): email addresses. phones (array of strings): phone numbers. organization (string): company name. job\_title (string): job title. notes (string): free-text notes. personFields (string, optional): fields to return in the response.                                                                                                                                                                                            |
| `create_contact_group`       | Create a new contact group. name (string, required): the group name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `remove_contacts_from_group` | Remove contacts from a contact group. resourceName (string, required): the group resource name (e.g. "contactGroups/abc123"). resourceNamesToRemove (array of strings, required): contact resource names to remove (e.g. \["people/12345"]).                                                                                                                                                                                                                                                                                                        |
| `update_contact`             | Update an existing contact. resourceName (string, required): the contact resource name (e.g. "people/12345"). etag (string, required): the contact etag from get\_contact — without it the update is rejected. given\_name (string): new first name. family\_name (string): new last name. emails (array of strings): new email addresses. phones (array of strings): new phone numbers. organization (string): new company name. job\_title (string): new job title. notes (string): new notes. personFields (string, optional): fields to return. |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.

***

*Last reviewed against the provider API: September 2026.*