skills.rest
FahadImdad
FahadImdadCOMMUNITY
Explore all skills by this author →
GitHub

hubspot-list-deals

List deals from HubSpot CRM with pagination and JSON output.

Updated Jan 22, 2026
Search Tags:#api#crm#list#hubspot#pagination#sales pipeline#deals
One-click install
npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-list-deals-fahadimdad
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hubspot-list-deals
Source: https://github.com/FahadImdad/Nexus-Fahad/tree/main/00-system/skills/hubspot/hubspot-list-deals
Command: npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-list-deals-fahadimdad

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually navigating the HubSpot UI to review your sales pipeline is slow and repetitive. This Skill retrieves your deal list directly from the HubSpot CRM API, so you can see deal names, amounts, stages, and close dates without leaving your conversation. ## Core Features & Use Cases - Paginated Deal Listing: Retrieve deals in configurable batches (default 10) using cursor-based pagination via the --limit and --after flags. - Structured JSON Output: Returns deal properties including dealname, amount, dealstage, pipeline, closedate, and 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: Ask for your current pipeline before a sales meeting and get a formatted list of open deals with amounts and stages, then page through older deals as needed. ## Quick Start Ask the AI to list your HubSpot deals, optionally specifying how many deals to return or which page cursor to continue from.

Frequently Asked Questions about hubspot-list-deals

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

FAQPage Schema
How do I list deals from HubSpot CRM?▼

Run the list_deals.py script with the --json flag after verifying your HubSpot configuration. It returns a paginated list of deals including name, amount, stage, pipeline, and close date.

How do I paginate through HubSpot deal results?▼

Pass the cursor value from the paging.next.after field of a previous response using the --after flag. Combine it with --limit to control how many deals each page returns.

What HubSpot API scope is needed to read deals?▼

Reading deals requires the crm.objects.deals.read scope on your HubSpot private app token. A 403 error indicates this scope is missing and must be added in your HubSpot app settings.

Why does HubSpot deal listing return a 401 or 429 error?▼

A 401 error means your access token is invalid and you should re-run the setup flow. A 429 error means you hit the HubSpot rate limit, so wait briefly and retry the request.

Can I filter HubSpot deals by stage or amount when listing?▼

This listing skill returns all deals with pagination only. To filter by name, amount, or stage, use the related hubspot-search-deals skill instead.

Related Skills

Explore More Marketing & Sales Skills→
selrai-companyselrai-company

hubspot-connector

Connect HubSpot CRM via MCP and manage contacts, companies, and deals.

Official
Advanced
wyre-technologywyre-technology
39

HubSpot Deals

Search, create, and update HubSpot deal records across pipeline stages.

Official
Intermediate
djinilabsdjinilabs
8

HubSpot Sales CRM

Manage contacts, companies, and deals via the HubSpot API.

Official
Intermediate
djinilabsdjinilabs
8

HubSpot Marketing Contacts

List, search, and retrieve HubSpot marketing contacts via the HubSpot API.

Official
Intermediate