Google Contacts by Apoth3osis

Name: Google Contacts
Brand: Apoth3osis
SKU: 697abb9f72860b342caa2962
Price: 0.05 USD
Availability: InStock

Google Contacts

Connector

Available ActionsEach successful request consumes credits as outlined below.

list_contacts^5crsearch_contacts^5crget_contact^5crcreate_contact^5crupdate_contact^5crdelete_contact^5cr

Details

Connect your AI agent to Google Contacts for complete contact management capabilities. Search contacts by name, email, or phone number to quickly find the people you need, list recent contacts for context during conversations, and create new contacts directly from agent interactions. Update existing contact information including phone numbers, emails, addresses, company details, and notes. This tool is perfect for agents that support customer outreach, sales engagement, scheduling coordination, and customer service workflows. Keep your contact database synchronized with your CRM, auto-fill customer details during support interactions, build outreach lists from existing contacts, and maintain a clean, organized address book. All operations use the Google People API with your connected Google account credentials.

Use Cases

Search contacts by name or email or phone, List recent contacts for conversation context, Create new contacts from agent interactions, Update contact phone numbers and emails, Add notes and organization details to contacts, Look up contacts by resource name, Sync contacts with external CRM systems, Auto-fill customer details during support, Build outreach lists from existing contacts, Maintain an organized address book

Credentials

Google OAuth *

Connect your Google account.

oauth token

Manage credentials in your dashboard.

Actions(6)

list_contacts^5cr2 params

List all contacts sorted by first name ascending.

page_sizeinteger

Max results per page (default 25, max 200)

Default: 25

Range: 1 - 200

page_tokenstring

Pagination token from a previous response

search_contacts^5cr3 params(1 required)

Search contacts by name, email, phone, or other text.

queryrequiredstring

Search text to match against contact fields

page_sizeinteger

Max results per page (default 25, max 200)

Default: 25

Range: 1 - 200

page_tokenstring

Pagination token from a previous response

get_contact^5cr1 param(1 required)

Retrieve a single contact by resource name.

resource_namerequiredstring

Contact resource name (e.g., 'people/c1234567890'). The 'people/' prefix is optional.

create_contact^5cr1 param(1 required)

Create a new contact. At least one field must be provided in the contact object.

contactrequiredobject

Contact data. At least one field is required. Also accepts Google People API format (names, emailAddresses, phoneNumbers arrays) and plural aliases (emails, phones).

Properties:

full_name(string)- Full name / display name. Used to derive first/last name if those are not provided.

first_name(string)- Given/first name

last_name(string)- Family/last name

email(string)- Primary email address

phone(string)- Primary phone number

company(string)- Organization/company name

job_title(string)- Job title

notes(string)- Notes / biography text

address(object)- Physical address

update_contact^5cr3 params(2 required)

Update an existing contact. Only the fields included in the contact object are modified; other fields remain unchanged.

resource_namerequiredstring

Contact resource name (e.g., 'people/c1234567890')

contactrequiredobject

Fields to update. Same structure as create_contact. Only provided fields are changed.

Properties:

full_name(string)- Full name / display name

first_name(string)- Given/first name

last_name(string)- Family/last name

email(string)- Primary email address

phone(string)- Primary phone number

company(string)- Organization/company name

job_title(string)- Job title

notes(string)- Notes / biography text

address(object)- Physical address

etagstring

ETag for optimistic concurrency. If omitted, the tool fetches it automatically.

delete_contact^5cr1 param(1 required)

Permanently delete a contact. This action is irreversible.

resource_namerequiredstring

Contact resource name (e.g., 'people/c1234567890')

Connect Your Agent In 5 Min

Use hosted MCP first, or install the local STDIO fallback when your client requires a command

Hosted Streamable HTTPS

Use the hosted endpoint directly in clients that support remote MCP. Store your Bearer token in the client config or secret field.

Endpoint: https://api.agentpmt.com/mcp
Authorization: Bearer <AGENTPMT_BEARER_TOKEN>

Full connection guide

Local STDIO Fallback

Use the local router for Claude Code, Codex, Cursor, Zed, and other clients that require a command-based MCP server. The router forwards requests to the hosted endpoint and does not execute tools locally.

npm install -g @agentpmt/mcp-routeragentpmt-setup

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ********" \
  -d '{
    "product_id": "697abb9f72860b342caa2962",
    "parameters": {
      "action": "list_contacts",
      "page_size": 25
    }
  }'

import requests
import json

url = "https://api.agentpmt.com/products/purchase"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ********"
}

data = {
    "product_id": "697abb9f72860b342caa2962",
    "parameters": {
        "action": "list_contacts",
        "page_size": 25
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json())

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "697abb9f72860b342caa2962",
  parameters: {
    "action": "list_contacts",
    "page_size": 25
  }
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(data)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

const axios = require('axios');

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "697abb9f72860b342caa2962",
  parameters: {
    "action": "list_contacts",
    "page_size": 25
  }
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

Login to view your API and budget keys. The example above uses placeholder values. Sign in to see personalized code with your bearer token.

Usage Instructions

Usage guidance provided directly by the developer for this product.

Google Contacts

Overview

Manage your Google Contacts: list, search, create, update, and delete contacts. Supports both simple flat-field input and canonical Google People API format for maximum flexibility.

Actions

list_contacts

List all contacts sorted by first name ascending.

Required fields: none (just the action)

Optional fields:

page_size (integer, 1-200, default 25) - number of contacts per page
page_token (string) - pagination token from a previous response

Example:

{
  "action": "list_contacts",
  "page_size": 50
}

Response includes: array of contacts (each with resource_name, etag, name, first_name, last_name, emails, phones, company, job_title, notes, addresses) and next_page_token if more results exist.

search_contacts

Search contacts by name, email, phone, or other text.

Required fields:

query (string) - search text to match against contact fields

Optional fields:

page_size (integer, 1-200, default 25)
page_token (string)

Example:

{
  "action": "search_contacts",
  "query": "Jane Smith",
  "page_size": 10
}

get_contact

Retrieve a single contact by resource name.

Required fields:

resource_name (string) - contact identifier, e.g. "people/c1234567890"

Example:

{
  "action": "get_contact",
  "resource_name": "people/c1234567890"
}

Note: You can pass the ID with or without the people/ prefix; it will be normalized automatically.

create_contact

Create a new contact. At least one field must be provided in the contact object.

Required fields:

contact (object) - contact data with at least one field

Contact object fields (all optional, but at least one required):

first_name (string) - given name
last_name (string) - family name
full_name (string) - display name (used to derive first/last if those are not provided; splits on spaces)
email (string) - primary email address
phone (string) - primary phone number
company (string) - organization name
job_title (string) - job title
notes (string) - free-text notes
address (object) - with fields: street_address, city, region, postal_code, country

Example:

{
  "action": "create_contact",
  "contact": {
    "first_name": "Jane",
    "last_name": "Smith",
    "email": "jane.smith@example.com",
    "phone": "+1-555-867-5309",
    "company": "Acme Corp",
    "job_title": "VP of Engineering",
    "notes": "Met at the 2026 tech conference",
    "address": {
      "street_address": "123 Main St",
      "city": "San Francisco",
      "region": "CA",
      "postal_code": "94105",
      "country": "US"
    }
  }
}

Alternative input formats: The contact object also accepts canonical Google People API format (e.g. names, emailAddresses, phoneNumbers arrays) and plural aliases (emails, phones arrays). The first element of each array is used.

update_contact

Update an existing contact. Only the fields you include in the contact object will be modified; other fields remain unchanged.

Required fields:

resource_name (string) - the contact to update, e.g. "people/c1234567890"
contact (object) - fields to update (same structure as create_contact)

Optional fields:

etag (string) - ETag for optimistic concurrency. If omitted, the tool fetches the current ETag automatically.

Example:

{
  "action": "update_contact",
  "resource_name": "people/c1234567890",
  "contact": {
    "job_title": "CTO",
    "company": "New Ventures Inc"
  }
}

Note: The update mask is automatically derived from the fields you provide. For example, providing email updates only the emailAddresses field on the contact.

delete_contact

Permanently delete a contact.

Required fields:

resource_name (string) - the contact to delete, e.g. "people/c1234567890"

Example:

{
  "action": "delete_contact",
  "resource_name": "people/c1234567890"
}

Warning: This action is irreversible. The contact is permanently removed.

Common Workflows

1. Find and Update a Contact

Search for a contact, then update their information:

search_contacts with query: "Jane Smith" to find the contact
Note the resource_name from the result (e.g. "people/c1234567890")
update_contact with that resource_name and the fields to change

2. Export a Contact List

Retrieve all contacts with pagination:

list_contacts with page_size: 200 (maximum per page)
If next_page_token is returned, call list_contacts again with that page_token
Repeat until no next_page_token is returned

3. Add a New Contact and Verify

Create a contact and confirm it was saved:

create_contact with the contact details
Note the resource_name from the response
get_contact with that resource_name to verify all fields were saved correctly

Important Notes

Pagination: Maximum page_size is 200. Default is 25. Use next_page_token to retrieve additional pages.
Resource names: Contact identifiers look like "people/c1234567890". You can pass just the ID portion (e.g. "c1234567890") and it will be normalized.
Name derivation: If you provide full_name without first_name/last_name, the tool splits on spaces: first word becomes given name, remaining words become family name.
Update behavior: Only fields included in the contact object are updated. Omitted fields are not cleared.
ETag handling: For updates, the ETag is fetched automatically if not provided. You can pass the etag from a previous get/list response for optimistic concurrency control.
Single values only: The flat input format (email, phone) stores one value per field. If you need multiple emails or phones, use the People API array format (emailAddresses, phoneNumbers), though only the first entry in each array is used.
Sorting: list_contacts always returns results sorted by first name ascending.
Delete is permanent: There is no undo for delete_contact.

Frequently Asked Questions

How do I connect this tool to an external agent?

You can install the local MCP server by opening a terminal and running:

Install commands

npm install -g @agentpmt/mcp-router
agentpmt-setup

This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc.

Alternatively you can connect to the hosted version with this config block, no installation required:

Hosted MCP config

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

View MCP Connection Instructions for more details.

How does an external agent use this tool?

After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent:

Agent prompt

Call the AgentPMT-Tool-Search-and-Execution tool with action 'get_schema' and tool_id 697abb9f72860b342caa2962 ("Google Contacts"). Then call the same tool with action 'call_tool', tool_id 697abb9f72860b342caa2962, and the parameters needed for my request.

The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT.

Google Contacts

Available ActionsEach successful request consumes credits as outlined below.

Details

Use Cases

Credentials

Actions(6)

Connect Your Agent In 5 Min

Hosted Streamable HTTPS

Local STDIO Fallback

Credit-Based Access Using AgentAddress

Direct x402 Payment

Usage Instructions

Google Contacts

Overview

Actions

list_contacts

search_contacts

get_contact

create_contact

update_contact

delete_contact

Common Workflows

1. Find and Update a Contact

2. Export a Contact List

3. Add a New Contact and Verify

Important Notes

Frequently Asked Questions

How do I connect this tool to an external agent?

How does an external agent use this tool?

Workflows Using This Tool

Send Flowers and Thank You Card to Google Contact

Gmail Smart Inbox: Filter, Draft Responses, and Discord Summary

Looking for help integrating AI into your business? Set up a free consultation.