hubspot-list-calls

abdullahbeam's avatarfrom abdullahbeam

List call engagements from HubSpot CRM. Load when user says 'list calls', 'show calls', 'call history', 'hubspot calls'. Returns logged call records.

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

When & Why to Use This Skill

This Claude skill enables users to seamlessly retrieve and list call engagement records directly from HubSpot CRM. It provides a streamlined way to access communication history, including call titles, durations, directions, and detailed notes, facilitating better relationship management and sales tracking directly within the AI interface. By automating the retrieval of logged call data, it enhances productivity for sales and support teams who need quick access to interaction history.

Use Cases

  • Sales Performance Review: Quickly list and audit recent outbound calls to evaluate team activity levels and engagement quality.
  • Client Meeting Preparation: Retrieve historical call logs to gain context on previous conversations and customer pain points before a scheduled discovery or follow-up call.
  • CRM Data Verification: Efficiently confirm that call records, durations, and statuses are correctly logged in HubSpot without manual searching through the CRM UI.
  • Communication Tracking: Monitor the frequency of inbound and outbound calls to ensure consistent follow-up and relationship maintenance with high-priority leads.
namehubspot-list-calls
description"List call engagements from HubSpot CRM. Load when user says 'list calls', 'show calls', 'call history', 'hubspot calls'. Returns logged call records."

List HubSpot Calls

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

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

With Limit

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

With Pagination

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

Output Format

{
  "results": [
    {
      "id": "14772074448",
      "properties": {
        "hs_call_title": "Discovery Call",
        "hs_call_body": "Discussed requirements and timeline...",
        "hs_call_direction": "OUTBOUND",
        "hs_call_duration": "1800000",
        "hs_call_status": "COMPLETED",
        "hs_timestamp": "2025-12-13T10:00:00Z"
      }
    }
  ],
  "paging": {
    "next": {
      "after": "cursor_for_next_page"
    }
  }
}

Display Format

Found {count} calls:

1. Discovery Call
   Direction: Outbound
   Duration: 30 minutes
   Status: Completed
   Date: 2025-12-13 10:00
   Notes: Discussed requirements and timeline...
   ID: 14772074448

2. Follow-up Call
   Direction: Inbound
   ...

Call Direction Values

Value Meaning
OUTBOUND Made call
INBOUND Received call

Error Handling

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

Related Skills

  • hubspot-log-call - Log new call
  • hubspot-get-associations - Get call's linked contacts