Google Contacts Skill

Google Contacts Skill

Manage Google Contacts - create, list, and search contacts.

Tool: google_contacts

Consolidated Google Contacts tool with operation parameter.

Operations

create - Create a new contact

Example - Basic contact:

jsonCopy code
{
  "operation": "create",
  "first_name": "John",
  "last_name": "Smith",
  "email": "john.smith@example.com",
  "phone": "+1-555-123-4567"
}

Example - Full contact:

jsonCopy code
{
  "operation": "create",
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "jane.doe@company.com",
  "phone": "+1-555-987-6543",
  "company": "Acme Corporation",
  "job_title": "Senior Engineer",
  "notes": "Met at tech conference 2024"
}

list - List contacts

Example:

jsonCopy code
{
  "operation": "list",
  "page_size": 50,
  "sort_order": "FIRST_NAME_ASCENDING"
}

search - Search contacts

Example - Search by name:

jsonCopy code
{
  "operation": "search",
  "query": "John"
}

Example - Search by email domain:

jsonCopy code
{
  "operation": "search",
  "query": "@company.com"
}

get - Get contact details

Example:

jsonCopy code
{
  "operation": "get",
  "resource_name": "people/c1234567890"
}

update - Update a contact

Example:

jsonCopy code
{
  "operation": "update",
  "resource_name": "people/c1234567890",
  "update_email": "new.email@example.com",
  "update_job_title": "Director of Engineering"
}

delete - Delete a contact

Example:

jsonCopy code
{
  "operation": "delete",
  "resource_name": "people/c1234567890"
}

Contact Fields

Phone Number Formats

Accepted formats:

• +1-555-123-4567 (international)
• (555) 123-4567 (US format)
• 555-123-4567 (simple)
• 5551234567 (digits only)

Common Workflows

1. Add new contact: Create with basic info after meeting someone
2. Find contact: Search by name to get their details
3. Build mailing list: List contacts, filter by company
4. Update CRM: Export contacts for business use

Tips

• Search is case-insensitive
• Partial matches work for names
• Email search matches any part of address
• Use page_token for pagination through large lists

Setup Requirements

1. Connect Contacts node to AI Agent's input-tools handle
2. Authenticate with Google Workspace in Credentials Modal
3. Ensure People API (Contacts) scopes are authorized