Google Contacts
Arcade.dev LLM tools for Google Contacts
Google Contacts (Arcade.dev) toolkit enables LLM-driven apps to read, create, and manage a user's Google Contacts and profile data with OAuth-backed access. It provides consolidated contact operations and user environment insights for chatbots, CRMs, and automation.
Capabilities
- Create and update structured contact records (names, emails, phones) and return normalized contact payloads.
- Search and retrieve contacts by name, email, or phone with consistent result formatting and paging support.
- Access authenticated user profile and Contacts environment metadata (permissions, profile picture, email).
- Field validation, normalization, and merge/deduplication-ready metadata to aid downstream workflows.
OAuth Provider: google Scopes:
- https://www.googleapis.com/auth/contacts
- https://www.googleapis.com/auth/contacts.readonly
- https://www.googleapis.com/auth/userinfo.email
- https://www.googleapis.com/auth/userinfo.profile
Available tools(5)
| Tool name | Description | Secrets | |
|---|---|---|---|
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",
)
``` | |||
Search the user's contacts in Google Contacts by email address. | |||
Search the user's contacts in Google Contacts by name. | |||
Search the user's contacts in Google Contacts by phone number. | |||
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. |
Selected tools
No tools selected.
Click "Show all tools" to add tools.
Requirements
Select tools to see requirements
GoogleContacts.CreateContact
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Does not modify remote state.
May delete or overwrite remote data.
Safe to retry without extra side effects.
Can call out to external systems.
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", ) ```
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
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 |
phone_number | string | Optional | The optional phone number of the contact |
Requirements
Output
json— A dictionary containing the details of the created contactGoogleContacts.SearchContactsByEmail
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Does not modify remote state.
May delete or overwrite remote data.
Safe to retry without extra side effects.
Can call out to external systems.
Search the user's contacts in Google Contacts by email address.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
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 Google API) |
Requirements
Output
json— A dictionary containing the list of matching contactsGoogleContacts.SearchContactsByName
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Does not modify remote state.
May delete or overwrite remote data.
Safe to retry without extra side effects.
Can call out to external systems.
Search the user's contacts in Google Contacts by name.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
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 Google API) |
Requirements
Output
json— A dictionary containing the list of matching contactsGoogleContacts.SearchContactsByPhoneNumber
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Does not modify remote state.
May delete or overwrite remote data.
Safe to retry without extra side effects.
Can call out to external systems.
Search the user's contacts in Google Contacts by phone number.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
phone_number | string | Required | The phone number to search for |
limit | integer | Optional | The maximum number of contacts to return (30 is the max allowed by Google API) |
Requirements
Output
json— A dictionary containing the list of matching contactsGoogleContacts.WhoAmI
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Does not modify remote state.
May delete or overwrite remote data.
Safe to retry without extra side effects.
Can call out to external systems.
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.
Parameters
No parameters required.
Requirements
Output
json— Get comprehensive user profile and Google Contacts environment information.