hubspot-list-notes

Lists note engagements from HubSpot CRM with pagination and JSON output.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Retrieving logged note records from HubSpot CRM normally requires manual navigation through the CRM interface or writing custom API calls, which slows down reviewing customer interaction history. ## Core Features & Use Cases - Note Listing: Fetches note engagements from HubSpot CRM with configurable result limits and cursor-based pagination. - Structured JSON Output: Returns note IDs, HTML bodies, and timestamps in a parseable format for downstream processing. - Pre-Flight Config Check: Validates HubSpot credentials before execution and surfaces actionable errors for 401, 403, and 429 responses. - Use Case: A sales rep asks to see recent notes before a client call, and the Skill returns the latest 25 logged notes with dates and content for quick review. ## Quick Start Ask the AI to list the most recent notes from HubSpot, optionally specifying how many notes to return.

Frequently Asked Questions about hubspot-list-notes

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

FAQPage Schema
How do I list notes from HubSpot CRM?

Run the list_notes.py script with the --json flag after verifying your HubSpot configuration. Use --limit to control how many notes are returned, with a default of 10 notes per request.

How to paginate through HubSpot note results?

Pass the cursor value from the paging.next.after field in the previous response using the --after parameter. This retrieves the next page of note records until no further cursor is returned.

What HubSpot API scope is needed to read notes?

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

Why does HubSpot return a 429 error when listing notes?

A 429 response means the HubSpot API rate limit has been exceeded. Wait for the rate limit window to reset and retry the request, or reduce the frequency of consecutive calls.

Can HubSpot note content contain HTML formatting?

Yes, note bodies in the hs_note_body property can include HTML tags, links, and lists. Strip the HTML tags when you need plain text for display or downstream text processing.