hubspot-list-contacts

Lists contacts from HubSpot CRM with pagination and structured JSON output.

Updated Jan 22, 2026
One-click install
npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-list-contacts-fahadimdad
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hubspot-list-contacts
Source: https://github.com/FahadImdad/Nexus-Fahad/tree/main/00-system/skills/hubspot/hubspot-list-contacts
Command: npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-list-contacts-fahadimdad

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Retrieving contact records from HubSpot CRM normally requires writing API calls, handling authentication, and parsing paginated responses manually. This Skill wraps that workflow into a single command that returns a clean, paginated contact list. ## Core Features & Use Cases - Paginated Contact Listing: Fetch contacts in batches with a configurable limit and cursor-based pagination via the after parameter. - Structured JSON Output: Returns contact properties including email, first name, last name, phone, and company, plus a direct HubSpot record URL. - Pre-Flight Config Check: Validates HubSpot credentials before running, with clear error guidance for 401, 403, and 429 responses. - Use Case: A sales rep asks for the 25 most recent contacts to prepare an outreach list, and receives a formatted roster with names, emails, phone numbers, and companies. ## Quick Start Ask the AI to list your HubSpot contacts, optionally specifying how many contacts to return or a pagination cursor for the next page.

Frequently Asked Questions about hubspot-list-contacts

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

FAQPage Schema
How do I list contacts from HubSpot CRM?

Run the list_contacts.py script with the --json flag to retrieve contacts from HubSpot. By default it returns 10 contacts, and you can adjust the count with the --limit parameter.

How to paginate through HubSpot contact results?

Use the --after parameter with the cursor value returned in the paging.next.after field of the previous response. This fetches the next page of contacts until no further cursor is returned.

What HubSpot API scope is needed to read contacts?

Reading contacts requires the crm.objects.contacts.read scope on your HubSpot access token. A 403 error indicates this scope is missing and the token must be regenerated with the correct permissions.

Why does HubSpot return a 401 or 429 error?

A 401 error means the access token is invalid and setup must be re-run. A 429 error indicates rate limiting, which is resolved by waiting and retrying the request.

What contact fields does the HubSpot list API return?

The response includes each contact's id, email, firstname, lastname, phone, and company properties, along with a direct URL to the contact record in the HubSpot app.