ReddRadar
Agent skill
hubspot-search-contacts
Search contacts in HubSpot CRM by email, name, or company. Load when user says 'search contacts', 'find contact', 'lookup contact', 'search for [name]'.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/hubspot-search-contacts
SKILL.md
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_TOKENoperator (partial match) - Email search uses
EQoperator (exact match) - Company search uses
CONTAINS_TOKENoperator (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 contactshubspot-update-contact- Update found contacthubspot-create-contact- Create if not found
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?