Google Contacts
Arcade toolkit · docs.arcade.dev
The Google Contacts toolkit lets LLMs create and search contact records in a user's personal Google Contacts and, for Workspace users, query the organizational directory.
Capabilities
- Contact creation — create new personal contact records with any combination of given name, family name, email, and phone number.
- Multi-field personal contact search — find contacts by name, email address, or phone number across the authenticated user's personal contacts.
- Workspace directory search — resolve colleagues by name or email against the Google Workspace org directory, with paginated results (pass
next_page_tokenwith identical query and limit to continue; Google rejects mismatched continuation calls). - Identity & environment inspection — retrieve the authenticated user's profile (name, email, photo, Contacts permissions) via
WhoAmI, useful for debugging auth state or personalizing responses.
Tools6
GoogleContacts_CreateContact
Create a new contact record in Google Contacts. Examples: create_contact(given_name="Alice") create_contact(given_name="Alice", family_name="Smith") create_contact(given_name="Alice", email="alice@example.com") create_contact(given_name="Alice", phone_number="+1234567890") create_contact( given_name="Alice", family_name="Smith", email="alice@example.com", phone_number="+1234567890", )
GoogleContacts_SearchContactsByEmail
Search the user's contacts in Google Contacts by email address.
GoogleContacts_SearchContactsByName
Search the user's contacts in Google Contacts by name.
GoogleContacts_SearchContactsByPhoneNumber
Search the user's contacts in Google Contacts by phone number.
GoogleContacts_SearchDirectoryPeople
Search the user's Google Workspace organization directory by name or email. Use this to resolve a colleague's email address when they are not in the user's personal Contacts (e.g. someone elsewhere in the same company). Returns one page of people. When has_next_page is true, call again with the same query and limit plus the returned next_page_token to fetch the next page — Google rejects a continuation whose query or limit differs from the original call.
GoogleContacts_WhoAmI
Get comprehensive user profile and Google Contacts environment information. This tool provides detailed information about the authenticated user including their name, email, profile picture, Google Contacts access permissions, and other important profile details from Google services.