Google Contacts

Google Workspace

Search, create, and manage your Google Contacts and People

What You Can Do

Google Contacts (powered by the People API) is your address book for all Google services. OpenClaw lets you query and manage it programmatically.

  • Search contacts — Find people by name, email address, or phone number
  • Get contact details — Full profile: name, emails, phones, organization, addresses, birthday, notes
  • List contacts — Paginate through your entire contact list
  • Create contacts — Add new people with full profile fields
  • Update contacts — Modify any field on an existing contact
  • Delete contacts — Remove contacts permanently
  • Contact groups — List groups, create groups, add/remove members
  • Directory search — Search your organization's directory (Google Workspace accounts)
  • Other contacts — Access the "other contacts" section (people you've interacted with)
  • Batch operations — Create or update multiple contacts efficiently
  • Try Asking

  • "Find the contact info for Jane Smith"
  • "What phone number do I have for Acme Corp?"
  • "Create a new contact: name 'Marcus Lee', email 'marcus@startup.io', phone '555-0192'"
  • "Update Sarah's email address to sarah.new@company.com"
  • "Add all my client contacts to a group called 'Clients 2025'"
  • "List all contacts in my 'Investors' group"
  • "Search my organization directory for anyone in the legal department"
  • Pro Tips

  • Contact resource names look like `people/c12345678` — the agent resolves these from search results
  • The People API distinguishes between your contacts (explicitly saved) and "other contacts" (auto-saved from Gmail interactions)
  • Organization directory is only available for Google Workspace (formerly G Suite) accounts
  • Contact groups are the equivalent of labels — a contact can belong to multiple groups
  • Combine with Gmail: find a contact's email, then draft them a message
  • Combine with Calendar: look up a contact's info, then schedule a meeting and invite them