> ## 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.*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.