Google Contacts Action

Reads and writes the Google address book behind an account. Fifteen operations over contacts and contact groups — enough to keep a CRM and a personal address book in step without anyone copying rows by hand.

Setup

A Google credential with the contacts scope. The picker only offers connections that already carry it; if yours does not, reconnect the account and grant it.

Mode — action or AI toolkit

The Mode selector decides who drives the node. In Action mode you pick one operation and fill its fields, and the node does that every time it runs. In AI toolkit mode the operations become tools an AI Node can call, and the model chooses which one and with what arguments.

ℹToolkit mode is opt-in per node, and it is what makes this node show up in an AI Node's tool picker. A node left in Action mode is invisible to agents.

Operations

The Operation dropdown decides what the node does and which fields appear under it. These are the exact values the API validates against:

Value	In the dropdown	What it does
listContacts	List contacts	Paginated list of every contact in the user's address book.
searchContacts	Search contacts	Free-text search by name, email, phone, or organization.
getContact	Get contact	Fetch a single contact by its resourceName (e.g. people/c12345).
createContact	Create contact	Add a new contact. Pass fullName for auto split into given/family.
updateContact	Update contact	Update fields on an existing contact. Update mask is auto-derived.
deleteContact	Delete contact	Remove a contact by resourceName. Irreversible.
listContactGroups	List groups	List all contact groups (labels) the user has.
addContactToGroup	Add to group	Idempotent — no error if the contact is already in the group.
removeContactFromGroup	Remove from group	Idempotent — no error if the contact wasn't in the group.
batchCreateContacts	Batch create	Bulk-create up to 200 contacts in one call. Pass a `contacts` array.
batchUpdateContacts	Batch update	Bulk-update up to 200 contacts. Each entry needs a resourceName.
batchDeleteContacts	Batch delete	Bulk-delete up to 500 contacts by resourceName. Irreversible.
createContactGroup	Create group	Create a new contact group (label).
updateContactGroup	Rename group	Rename an existing group.
deleteContactGroup	Delete group	Delete a group. Optionally delete its contacts too.

Gotchas

resourceName is the identity — it looks like people/c12345 and it is what every read, update and delete keys on. Store it when you create a contact.
createContact accepts fullName and splits it into given and family names for you.
Search is free text across name, email, phone and organization — it is not a field-by-field filter.
Listing is paginated. The output is iterable, so a Loop downstream walks the address book one contact at a time.