hubspot-list-notes

name	hubspot-list-notes
description	List note engagements from HubSpot CRM. Load when user says 'list notes', 'show notes', 'note history', 'hubspot notes'. Returns logged note records.

List HubSpot Notes

Specialized skill for listing note engagements from 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

Basic List (default 10 notes)

python 00-system/skills/hubspot/hubspot-master/scripts/list_notes.py --json

With Limit

python 00-system/skills/hubspot/hubspot-master/scripts/list_notes.py --limit 25 --json

With Pagination

python 00-system/skills/hubspot/hubspot-master/scripts/list_notes.py --after "cursor_value" --json

---

Output Format

{
  "results": [
    {
      "id": "16977760701",
      "properties": {
        "hs_note_body": "<p>Important note about this contact...</p>",
        "hs_timestamp": "2025-12-13T10:00:00Z"
      }
    }
  ],
  "paging": {
    "next": {
      "after": "cursor_for_next_page"
    }
  }
}

---

Display Format

Found {count} notes:

1. Note ID: 16977760701
   Date: 2025-12-13 10:00
   Content: Important note about this contact...

2. Note ID: 16977942725
   Date: 2025-12-12 15:30
   Content: Meeting follow-up...

---

Note Content

• Notes can contain HTML formatting
• Strip HTML tags for plain text display
• Notes may include links, lists, and formatted text

---

Error Handling

Error	Solution
401	Invalid token - re-run setup
403	Missing crm.objects.notes.read scope
429	Rate limited - wait and retry

---

Related Skills

• hubspot-create-note - Create new note
• hubspot-get-associations - Get note's linked contacts