mcpField
G
get-contact

get-contact

github.com/aviz85Productivity5044 installsUpdated 16w ago
Repository

About get-contact

get-contact is a skill for finding email and phone details by searching a configured contact source, such as a local JSON file. It is intended for other skills that need contact lookup and requires user confirmation before contact information is used.

Key features

  1. 01Case-insensitive partial name search
  2. 02Searches a configured contact source
  3. 03Handles zero, one, or multiple matches
  4. 04Requires confirmation before use

Use cases

  1. 01Look up an email before another skill contacts someone
  2. 02Distinguish among contacts with the same name

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/aviz85/claude-skills-library --skill get-contact

After installing, type/get-contactin Claude Code to confirm it loaded.

Details

From the project README

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": "[email protected]",
    "phone": "+1234567890"
  }
}

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": "[email protected]",
      "phone": "+1234567890"
    }
  ]
}

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.

Comments

Markdown supported