Google Contacts
Description: Enable agents to interact with Google Contacts.
Author: Arcade
Auth: User authorization via the Google auth provider
The Arcade Google Contacts MCP Server 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
Available Tools
These tools are currently available in the Arcade Google Contacts MCP Sever.
| Tool Name | Description |
|---|---|
| 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.CreateContact | Create a new contact record in Google Contacts. |
| GoogleContacts.WhoAmI | Get comprehensive user profile and Google Contacts environment information. |
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.
Each tool requires specific Google OAuth scopes to function. You’ll find the required scopes listed in a blue info box at the end of each tool’s documentation below. For more information about configuring OAuth and tips for moving to production, see the Google auth provider documentation.
Find required scopes
Select the tools you plan to use to see the OAuth scopes your application needs:
Scope calculator
Select the tools you plan to use to see the required OAuth scopes.
Required scopes
Select tools above to see required scopes
GoogleContacts.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).
https://www.googleapis.com/auth/contacts.readonly
GoogleContacts.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).
https://www.googleapis.com/auth/contacts.readonly
GoogleContacts.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.phone_number(string, optional): The optional phone_number address of the contact.
https://www.googleapis.com/auth/contacts
GoogleContacts.WhoAmI
Get comprehensive user profile and Google Contacts environment information.
Parameters
This tool does not take any parameters.
https://www.googleapis.com/auth/contacts.readonlyhttps://www.googleapis.com/auth/userinfo.profilehttps://www.googleapis.com/auth/userinfo.email
Auth
The Arcade Google Contacts MCP Sever uses the Google auth provider to connect to users’ Google accounts.
With the Arcade Cloud Platform, 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.