get-contact

name	get-contact
description	Find contact details by name. Searches local contacts/CRM and returns email/phone. Use before scheduling meetings or sending messages when you need contact info.
version	1.0.0
author	aviz85
tags	["contacts","crm","utility"]
usedBy	["zoom-meeting","whatsapp","gmail"]

Get Contact

Find contact details (email, phone) by name search.

Sources

Configure your contact sources. Examples:

• Local JSON - ~/contacts.json or your CRM data file
• Google Contacts - via People API (future)
• Any CRM - adapt the search to your system

Usage

When you need contact info:

1. Search contacts for name (partial match, case insensitive)
2. If 0 results → tell user "not found, please provide email/phone"
3. If 1 result → confirm with user: "Found [name] - [email]. Is this correct?"
4. If multiple results → ask user to choose: "Found multiple: 1) Name A 2) Name B"

IMPORTANT

Always confirm with user before using contact info. Common names (יוסי, דוד, John, David) may have multiple people or user may mean someone not in contacts.

Search Example (JSON)

# Search by name in contacts file
jq '.contacts[] | select(.name | test("QUERY"; "i")) | {name, email, phone}' ~/contacts.json

Response Format

Return to calling skill:

{
  "found": true,
  "count": 1,
  "contact": {
    "name": "John Smith",
    "email": "[e-mail]",
    "phone": "[phone]"
  }
}

Or if multiple:

{
  "found": true,
  "count": 2,
  "contacts": [
    {"name": "John Smith", "email": "john.s@...", "phone": "..."},
    {"name": "John Doe", "email": "john.d@...", "phone": "..."}
  ]
}

Configuration

Create a contacts file or configure your data source path:

// ~/contacts.json
{
  "contacts": [
    {
      "name": "John Smith",
      "email": "[e-mail]",
      "phone": "[phone]"
    }
  ]
}

Update the search path in the skill to match your setup.

Integration

Other skills (zoom-meeting, whatsapp) use this skill to lookup contacts. If this skill isn't available, those skills will ask the user for contact details directly.