hubspot-search-contacts

Search HubSpot CRM contacts by email, name, or company filters.

2|1|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/abdullahbeam/nexus-design-abdullah --skill hubspot-search-contacts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hubspot-search-contacts
Source: https://github.com/abdullahbeam/nexus-design-abdullah/tree/main/00-system/skills/hubspot/hubspot-search-contacts
Command: npx skills add https://github.com/abdullahbeam/nexus-design-abdullah --skill hubspot-search-contacts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually searching through HubSpot CRM to locate specific contacts is slow and inefficient, especially when working with large contact lists or needing to find leads, customers, or partners on demand.

Core Features & Use Cases

  • Multi-field search: Look up contacts by exact email, partial first/last name, or partial company name, with support for combining multiple filters to narrow results.
  • Structured output: Returns contact details including unique ID, email, full name, and company in both human-readable formatted lists and machine-readable JSON.
  • Use Case: A sales representative can use this skill to instantly find a prospect's record using just their work email, or a support agent can locate a customer by first name and company to pull up their account details quickly.

Quick Start

Use the hubspot-search-contacts skill to find the contact with the email [email protected].

Frequently Asked Questions about hubspot-search-contacts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search for HubSpot CRM contacts by email or company name?

You can search HubSpot CRM contacts by exact email, partial first or last name, or partial company name. The skill combines multiple filters to narrow results, returning structured contact details like unique ID, email, and company.

Do I need API credentials to look up customer data in HubSpot?

Yes, you need valid HubSpot API credentials with the crm.objects.contacts.read scope. These permissions allow the script to execute filtered queries and retrieve structured contact records from your CRM.

What is the best way to retrieve lead records from HubSpot without manual searching?

Using a filtered search skill automates lead lookup work in HubSpot. It retrieves contact data via email, name, or company filters, returning both human-readable lists and machine-readable JSON.

Can I combine multiple filters when finding contacts in HubSpot for sales workflows?

Yes, you can combine multiple filters to narrow your contact search results. This applies directly to sales, support, and go-to-market workflows requiring fast retrieval of contact data.

How does the HubSpot contact search script return results for integration?

The script returns contact details including unique ID, email, full name, and company. Results are structured in both human-readable formatted lists and machine-readable JSON for integration.

Why use an API integration for HubSpot contact lookup instead of manual methods?

Manual CRM searching is slow for large lists. An API integration executes filtered queries instantly, eliminating manual lookup work and returning structured contact results in seconds.