IntegrationsProductivity & DocsGoogleContacts

Calendar

Description: Enable agents to interact with Google Contacts.

Author: Arcade

Code: GitHub

Auth: User authorization via the Google auth provider

PyPI VersionLicensePython VersionsWheel StatusDownloads

The Arcade Contacts toolkit provides a pre-built set of tools for interacting with Google Contacts. These tools make it easy to build agents and AI apps that can:

  • Create new contacts
  • Search for contacts by name or email

Install

pip install arcade_google

pip installing the toolkit is only needed if you are self-hosting Arcade. You do not need to install the toolkit if you’re using Arcade Cloud.

Available Tools

These tools are currently available in the Arcade Contacts toolkit.

Tool NameDescription
SearchContactsByEmailSearch the user's contacts in Google Contacts by email address.
SearchContactsByNameSearch the user's contacts in Google Contacts by name.
CreateContactCreate a new contact record in Google Contacts.

If you need to perform an action that’s not listed here, you can get in touch with us to request a new tool, or create your own tools with the Google auth provider.

SearchContactsByEmail

Search the user’s contacts in Google Contacts by email address.

Parameters

  • email (string, required): The email address to search for.
  • limit (integer, optional): The maximum number of contacts to return (30 is the max allowed by the Google API).

SearchContactsByName

Search the user’s contacts in Google Contacts by name.

Parameters

  • name (string, required): The full name to search for.
  • limit (integer, optional): The maximum number of contacts to return (30 is the max allowed by the Google API).

CreateContact

Create a new contact record in Google Contacts.

Parameters

  • given_name (string, required): The given name of the contact.
  • family_name (string, optional): The optional family name of the contact.
  • email (string, optional): The optional email address of the contact.

Auth

The Arcade Contacts toolkit uses the Google auth provider to connect to users’ Google accounts.

With the hosted Arcade Engine, there’s nothing to configure. Your users will see Arcade as the name of the application that’s requesting permission.

With a self-hosted installation of Arcade, you need to configure the Google auth provider with your own Google app credentials.