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

Related Skills

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