OpenParable
Skip to content
← Back to skills

Google Contacts Skill

Apps & Automation
google-contacts-skill

Google Contacts Skill is an Agent Skill for apps & automation published in the zeenie-ai/OpenCompany repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Create, list, and search Google Contacts. Supports names, emails, phone numbers, and organizations.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/zeenie-ai/OpenCompany/blob/HEAD/server/skills/productivity_agent/google-contacts-skill/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/google-contacts-skill, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Google Contacts Skill

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

Tool: google_contacts

Consolidated Google Contacts tool with operation parameter.

Operations

OperationDescriptionRequired Fields
createCreate a new contactfirst_name
listList contacts(none)
searchSearch contacts by queryquery
getGet contact detailsresource_name
updateUpdate existing contactresource_name
deleteDelete a contactresource_name

create - Create a new contact

FieldTypeRequiredDescription
operationstringYesMust be "create"
first_namestringYesContact's first name
last_namestringNoContact's last name
emailstringNoEmail address
phonestringNoPhone number
companystringNoCompany/organization name
job_titlestringNoJob title
notesstringNoNotes about contact

Example - Basic contact:

{
  "operation": "create",
  "first_name": "John",
  "last_name": "Smith",
  "email": "[email protected]",
  "phone": "+1-555-123-4567"
}

Example - Full contact:

{
  "operation": "create",
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "[email protected]",
  "phone": "+1-555-987-6543",
  "company": "Acme Corporation",
  "job_title": "Senior Engineer",
  "notes": "Met at tech conference 2024"
}

list - List contacts

FieldTypeRequiredDescription
operationstringYesMust be "list"
page_sizeintegerNoResults per page (default: 20, max: 100)
page_tokenstringNoToken for next page
sort_orderstringNoLAST_MODIFIED_ASCENDING, LAST_MODIFIED_DESCENDING, FIRST_NAME_ASCENDING, LAST_NAME_ASCENDING

Example:

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

search - Search contacts

FieldTypeRequiredDescription
operationstringYesMust be "search"
querystringYesSearch query (name or email)
page_sizeintegerNoResults per page (default: 10, max: 30)

Example - Search by name:

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

Example - Search by email domain:

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

get - Get contact details

FieldTypeRequiredDescription
operationstringYesMust be "get"
resource_namestringYesContact resource name (e.g., "people/c1234567890")

Example:

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

update - Update a contact

FieldTypeRequiredDescription
operationstringYesMust be "update"
resource_namestringYesContact resource name
update_first_namestringNoNew first name
update_last_namestringNoNew last name
update_emailstringNoNew email
update_phonestringNoNew phone
update_companystringNoNew company
update_job_titlestringNoNew job title

Example:

{
  "operation": "update",
  "resource_name": "people/c1234567890",
  "update_email": "[email protected]",
  "update_job_title": "Director of Engineering"
}

delete - Delete a contact

FieldTypeRequiredDescription
operationstringYesMust be "delete"
resource_namestringYesContact resource name

Example:

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

Contact Fields

FieldDescription
resource_nameUnique identifier (people/cXXX)
display_nameFull formatted name
first_nameGiven name
last_nameFamily name
emailPrimary email address
phonePrimary phone number
companyOrganization name
job_titlePosition/title
notesFree-form notes

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