hubspot-list-contacts

abdullahbeam's avatarfrom abdullahbeam

List contacts from HubSpot CRM. Load when user says 'list contacts', 'show contacts', 'get contacts', 'hubspot contacts'. Returns paginated contact list with email, name, phone, company.

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 30, 2025
[CRM Workflows]

When & Why to Use This Skill

The HubSpot List Contacts skill enables seamless integration between Claude and your HubSpot CRM, allowing for the efficient retrieval and display of contact records. By providing instant access to essential data such as names, emails, phone numbers, and company details directly within the chat, it streamlines lead management and enhances sales productivity through automated data fetching and pagination support.

Use Cases

  • Sales Call Preparation: Quickly pull up a contact's details and company information to gain context before reaching out to a prospect.
  • Lead Pipeline Review: Browse through lists of contacts to monitor recent sign-ups or identify specific leads that require follow-up.
  • CRM Data Auditing: Use paginated results to scan through contact records and identify missing information like phone numbers or incorrect company names.
  • Workflow Efficiency: Retrieve specific contact IDs and properties to facilitate subsequent actions like updating records or adding contacts to marketing sequences.
namehubspot-list-contacts
description"List contacts from HubSpot CRM. Load when user says 'list contacts', 'show contacts', 'get contacts', 'hubspot contacts'. Returns paginated contact list with email, name, phone, company."

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