How do I install the Hubspot Search Contacts skill?

Run npx skillmds@latest add majiayu000/hubspot-search-contacts in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Hubspot Search Contacts safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Hubspot Search Contacts?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Hubspot Search Contacts free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Hubspot Search Contacts?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Hubspot Search Contacts by majiayu000

Name: Hubspot Search Contacts
Rating: 4.2 (5 reviews)
Author: majiayu000

File contents

Search HubSpot Contacts

Specialized skill for searching contacts in HubSpot CRM.

Pre-Flight Check

Before running, execute config check:

python 00-system/skills/hubspot/hubspot-master/scripts/check_hubspot_config.py --json

If ai_action is not proceed_with_operation, follow hubspot-connect setup guide.

Usage

Search by Email

python 00-system/skills/hubspot/hubspot-master/scripts/search_contacts.py \
  --email "john@example.com" \
  --json

Search by Name

python 00-system/skills/hubspot/hubspot-master/scripts/search_contacts.py \
  --name "John" \
  --json

Search by Company

python 00-system/skills/hubspot/hubspot-master/scripts/search_contacts.py \
  --company "Acme" \
  --json

Combined Search with Limit

python 00-system/skills/hubspot/hubspot-master/scripts/search_contacts.py \
  --name "John" \
  --company "Acme" \
  --limit 20 \
  --json

Output Format

{
  "total": 5,
  "results": [
    {
      "id": "12345",
      "properties": {
        "email": "john@example.com",
        "firstname": "John",
        "lastname": "Doe",
        "company": "Acme Corp"
      },
      "url": "https://app.hubspot.com/..."
    }
  ]
}

Display Format

Found 5 contacts matching "John":

1. John Doe
   Email: john@example.com
   Company: Acme Corp
   ID: 12345

2. Johnny Smith
   Email: johnny@corp.com
   Company: Tech Inc
   ID: 12346
   ...

Search Behavior

Name search uses CONTAINS_TOKEN operator (partial match)
Email search uses EQ operator (exact match)
Company search uses CONTAINS_TOKEN operator (partial match)
Multiple filters are combined with AND logic

Error Handling

Error	Solution
401	Invalid token - re-run setup
403	Missing `crm.objects.contacts.read` scope
429	Rate limited - wait and retry

Related Skills

hubspot-list-contacts - List all contacts
hubspot-update-contact - Update found contact
hubspot-create-contact - Create if not found

---name: hubspot-search-contactsdescription: Search contacts in HubSpot CRM by email, name, or company. Load when user says 'search contacts', 'find contact', 'lookup contact', 'search for [name]'.--- # Search HubSpot Contacts **Specialized skill** for searching contacts in HubSpot CRM. ## Pre-Flight Check Before running, execute config check: ```bash python 00-system/skills/hubspot/hubspot-master/scripts/check_hubspot_config.py --json ``` If `ai_action` is not `proceed_with_operation`, follow hubspot-connect setup guide. --- ## Usage ### Search by Email ```bash python 00-system/skills/hubspot/hubspot-master/scripts/search_contacts.py \ --email "john@example.com" \ --json ``` ### Search by Name ```bash python 00-system/skills/hubspot/hubspot-master/scripts/search_contacts.py \ --name "John" \ --json ``` ### Search by Company ```bash python 00-system/skills/hubspot/hubspot-master/scripts/search_contacts.py \ --company "Acme" \ --json ``` ### Combined Search with Limit ```bash python 00-system/skills/hubspot/hubspot-master/scripts/search_contacts.py \ --name "John" \ --company "Acme" \ --limit 20 \ --json ``` --- ## Output Format ```json { "total": 5, "results": [ { "id": "12345", "properties": { "email": "john@example.com", "firstname": "John", "lastname": "Doe", "company": "Acme Corp" }, "url": "https://app.hubspot.com/..." } ] } ``` --- ## Display Format ``` Found 5 contacts matching "John": 1. John Doe Email: john@example.com Company: Acme Corp ID: 12345 2. Johnny Smith Email: johnny@corp.com Company: Tech Inc ID: 12346 ... ``` --- ## Search Behavior - Name search uses `CONTAINS_TOKEN` operator (partial match) - Email search uses `EQ` operator (exact match) - Company search uses `CONTAINS_TOKEN` operator (partial match) - Multiple filters are combined with AND logic --- ## Error Handling | Error | Solution | |-------|----------| | 401 | Invalid token - re-run setup | | 403 | Missing `crm.objects.contacts.read` scope | | 429 | Rate limited - wait and retry | --- ## Related Skills - `hubspot-list-contacts` - List all contacts - `hubspot-update-contact` - Update found contact - `hubspot-create-contact` - Create if not found

Frequently asked questions

Hubspot Search Contacts