List HubSpot Contacts Skill

List HubSpot Contacts

Specialized skill for listing contacts 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 contacts)

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

With Limit

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

With Pagination (after cursor)

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

Output Format

{
  "results": [
    {
      "id": "12345",
      "properties": {
        "email": "john@example.com",
        "firstname": "John",
        "lastname": "Doe",
        "phone": "+1234567890",
        "company": "Acme Corp"
      },
      "url": "https://app.hubspot.com/contacts/.../record/0-1/12345"
    }
  ],
  "paging": {
    "next": {
      "after": "cursor_for_next_page"
    }
  }
}

Display Format

Present results to user as:

Found {count} contacts:

1. John Doe
   Email: john@example.com
   Phone: +1234567890
   Company: Acme Corp
   ID: 12345

2. Jane Smith
   Email: jane@example.com
   ...

Error Handling

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

Related Skills

hubspot-create-contact - Create new contact
hubspot-search-contacts - Search by email/name
hubspot-update-contact - Update existing contact

Agent Skills: List HubSpot Contacts

Install this agent skill to your local

Skill Files