Server Details
| Property | Value |
|---|---|
| Transport | Streamable HTTP |
| Hosting | Remote (externally hosted) |
| Categories | Productivity & Collaboration, Business Operations, Google |
Authentication
This server supports the following authentication method:OAuth
Scopes:openid, email, profile, https://www.googleapis.com/auth/contacts, https://www.googleapis.com/auth/contacts.readonly
During the server onboarding flow, you will be prompted to complete the OAuth flow to grant access. See the Google Contacts Authentication guide for step-by-step credential configuration.
Getting Started
Add the server
Navigate to the Server Library and click on the New Server button. Find Google Contacts in the Caylex Catalog.
Use in a project
Add the server to a project by configuring project connections. Its tools are now available to any agents connected to that project.
Available Tools
This server provides 16 tools:contacts_get_current_user
contacts_get_current_user
Returns the authenticated user’s account information for use with Contacts tools. Use the returned email as user_google_email when calling contacts_* tools. Uses the Bearer token from the request’s Authorization header.
get_contact
get_contact
Get detailed information about a specific contact.Use contacts_get_current_user to get the user_google_email or account information.Args:
user_google_email (str): The user’s Google email address. Required.
contact_id (str): The contact ID (e.g., “c1234567890” or full resource name “people/c1234567890”).Returns:
str: Detailed contact information.
contacts_create_contact
contacts_create_contact
Create a new contact.Use contacts_get_current_user to get the user_google_email or account information.Args:
user_google_email (str): The user’s Google email address. Required.
given_name (Optional[str]): First name.
family_name (Optional[str]): Last name.
email (Optional[str]): Email address.
phone (Optional[str]): Phone number.
organization (Optional[str]): Company/organization name.
job_title (Optional[str]): Job title.
notes (Optional[str]): Additional notes.Returns:
str: Confirmation with the new contact’s details.
contacts_get_contact_group
contacts_get_contact_group
Get details of a specific contact group including its members.Use contacts_get_current_user to get the user_google_email or account information.Args:
user_google_email (str): The user’s Google email address. Required.
group_id (str): The contact group ID.
max_members (int): Maximum number of members to return (default: 100, max: 1000).Returns:
str: Contact group details including members.
contacts_batch_update_contacts
contacts_batch_update_contacts
Update multiple contacts in a batch operation.Use contacts_get_current_user to get the user_google_email or account information.Args:
user_google_email (str): The user’s Google email address. Required.
updates (List[Dict[str, str]]): List of update dictionaries with fields:
- contact_id: The contact ID to update (required)
- given_name: New first name
- family_name: New last name
- email: New email address
- phone: New phone number
- organization: New company name
- job_title: New job title
contacts_update_contact
contacts_update_contact
Update an existing contact. Note: This replaces fields, not merges them.Use contacts_get_current_user to get the user_google_email or account information.Args:
user_google_email (str): The user’s Google email address. Required.
contact_id (str): The contact ID to update.
given_name (Optional[str]): New first name.
family_name (Optional[str]): New last name.
email (Optional[str]): New email address.
phone (Optional[str]): New phone number.
organization (Optional[str]): New company/organization name.
job_title (Optional[str]): New job title.
notes (Optional[str]): New notes.Returns:
str: Confirmation with updated contact details.
contacts_delete_contact
contacts_delete_contact
Delete a contact.Use contacts_get_current_user to get the user_google_email or account information.Args:
user_google_email (str): The user’s Google email address. Required.
contact_id (str): The contact ID to delete.Returns:
str: Confirmation message.
contacts_batch_delete_contacts
contacts_batch_delete_contacts
Delete multiple contacts in a batch operation.Use contacts_get_current_user to get the user_google_email or account information.Args:
user_google_email (str): The user’s Google email address. Required.
contact_ids (List[str]): List of contact IDs to delete.Returns:
str: Confirmation message.
contacts_create_contact_group
contacts_create_contact_group
Create a new contact group (label).Use contacts_get_current_user to get the user_google_email or account information.Args:
user_google_email (str): The user’s Google email address. Required.
name (str): The name of the new contact group.Returns:
str: Confirmation with the new group details.
contacts_update_contact_group
contacts_update_contact_group
Update a contact group’s name.Use contacts_get_current_user to get the user_google_email or account information.Args:
user_google_email (str): The user’s Google email address. Required.
group_id (str): The contact group ID to update.
name (str): The new name for the contact group.Returns:
str: Confirmation with updated group details.
contacts_delete_contact_group
contacts_delete_contact_group
Delete a contact group.Use contacts_get_current_user to get the user_google_email or account information.Args:
user_google_email (str): The user’s Google email address. Required.
group_id (str): The contact group ID to delete.
delete_contacts (bool): If True, also delete contacts in the group (default: False).Returns:
str: Confirmation message.
contacts_list_contact_groups
contacts_list_contact_groups
List contact groups (labels) for the user.Use contacts_get_current_user to get the user_google_email or account information.Args:
user_google_email (str): The user’s Google email address. Required.
page_size (int): Maximum number of groups to return (default: 100, max: 1000).
page_token (Optional[str]): Token for pagination.Returns:
str: List of contact groups with their details.
contacts_batch_create_contacts
contacts_batch_create_contacts
Create multiple contacts in a batch operation.Use contacts_get_current_user to get the user_google_email or account information.Args:
user_google_email (str): The user’s Google email address. Required.
contacts (List[Dict[str, str]]): List of contact dictionaries with fields:
- given_name: First name
- family_name: Last name
- email: Email address
- phone: Phone number
- organization: Company name
- job_title: Job title
contacts_modify_contact_group_members
contacts_modify_contact_group_members
Add or remove contacts from a contact group.Use contacts_get_current_user to get the user_google_email or account information.Args:
user_google_email (str): The user’s Google email address. Required.
group_id (str): The contact group ID.
add_contact_ids (Optional[List[str]]): Contact IDs to add to the group.
remove_contact_ids (Optional[List[str]]): Contact IDs to remove from the group.Returns:
str: Confirmation with results.
contacts_list_contacts
contacts_list_contacts
List contacts for the authenticated user.Use contacts_get_current_user to get the user_google_email or account information.Args:
user_google_email (str): The user’s Google email address. Required.
page_size (int): Maximum number of contacts to return (default: 100, max: 1000).
page_token (Optional[str]): Token for pagination.
sort_order (Optional[str]): Sort order: “LAST_MODIFIED_ASCENDING”, “LAST_MODIFIED_DESCENDING”, “FIRST_NAME_ASCENDING”, or “LAST_NAME_ASCENDING”.Returns:
str: List of contacts with their basic information.
contacts_search_contacts
contacts_search_contacts
Search contacts by name, email, phone number, or other fields.Use contacts_get_current_user to get the user_google_email or account information.Args:
user_google_email (str): The user’s Google email address. Required.
query (str): Search query string (searches names, emails, phone numbers).
page_size (int): Maximum number of results to return (default: 30, max: 30).Returns:
str: Matching contacts with their basic information.
Related Servers
Gmail
Google Calendar
