Google Contacts Skill

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

Available Tools

contacts_create

Create a new contact.

Example - Basic contact:

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

Example - Full contact:

{
  "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"
}

Response:

{
  "success": true,
  "resource_name": "people/c1234567890",
  "display_name": "John Smith",
  "email": "john.smith@example.com",
  "phone": "+1-555-123-4567"
}

contacts_list

List contacts from your address book.

Example - List contacts:

{
  "page_size": 50,
  "sort_order": "FIRST_NAME_ASCENDING"
}

Response:

{
  "contacts": [
    {
      "resource_name": "people/c1234567890",
      "display_name": "Alice Johnson",
      "email": "alice@example.com",
      "phone": "+1-555-111-2222",
      "company": "Tech Corp",
      "job_title": "Product Manager"
    },
    {
      "resource_name": "people/c0987654321",
      "display_name": "Bob Williams",
      "email": "bob@example.com",
      "phone": "+1-555-333-4444"
    }
  ],
  "count": 2,
  "next_page_token": "..."
}

contacts_search

Search contacts by name or email.

Example - Search by name:

{
  "query": "John"
}

Example - Search by email domain:

{
  "query": "@company.com"
}

Response:

{
  "contacts": [
    {
      "resource_name": "people/c1234567890",
      "display_name": "John Smith",
      "email": "john.smith@example.com",
      "phone": "+1-555-123-4567",
      "company": "Example Inc"
    }
  ],
  "count": 1
}

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 nodes to AI Agent's input-tools handle
2. Authenticate with Google Workspace in Credentials Modal
3. Ensure People API (Contacts) scopes are authorized