home / skills / abdullahbeam / nexus-design-abdullah / hubspot-list-meetings

hubspot-list-meetings skill

safe

/00-system/skills/hubspot/hubspot-list-meetings

This skill lists HubSpot meetings from your CRM, returning scheduled records and enabling quick review of upcoming engagements.

npx playbooks add skill abdullahbeam/nexus-design-abdullah --skill hubspot-list-meetings

Review the files below or copy the command above to add this skill to your agents.

Files (1)

SKILL.md

2.0 KB

---
name: hubspot-list-meetings
description: "List meeting engagements from HubSpot CRM. Load when user says 'list meetings', 'show meetings', 'meeting history', 'hubspot meetings'. Returns scheduled meeting records."
---

# List HubSpot Meetings

**Specialized skill** for listing meeting engagements from HubSpot CRM.

## Pre-Flight Check

Before running, execute config check:
```bash
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 meetings)
```bash
python 00-system/skills/hubspot/hubspot-master/scripts/list_meetings.py --json
```

### With Limit
```bash
python 00-system/skills/hubspot/hubspot-master/scripts/list_meetings.py --limit 25 --json
```

### With Pagination
```bash
python 00-system/skills/hubspot/hubspot-master/scripts/list_meetings.py --after "cursor_value" --json
```

---

## Output Format

```json
{
  "results": [
    {
      "id": "14771947458",
      "properties": {
        "hs_meeting_title": "Product Demo",
        "hs_meeting_body": "Demo of new features for enterprise team",
        "hs_meeting_start_time": "2025-12-15T14:00:00Z",
        "hs_meeting_end_time": "2025-12-15T15:00:00Z",
        "hs_timestamp": "2025-12-15T14:00:00Z"
      }
    }
  ],
  "paging": {
    "next": {
      "after": "cursor_for_next_page"
    }
  }
}
```

---

## Display Format

```
Found {count} meetings:

1. Product Demo
   Start: 2025-12-15 14:00
   End: 2025-12-15 15:00
   Duration: 1 hour
   Notes: Demo of new features for enterprise team
   ID: 14771947458

2. Discovery Call
   Start: 2025-12-16 10:00
   ...
```

---

## Error Handling

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

---

## Related Skills

- `hubspot-create-meeting` - Schedule new meeting
- `hubspot-get-associations` - Get meeting attendees

Overview

This skill lists meeting engagements from a HubSpot CRM account and returns scheduled meeting records in a concise, machine-friendly format. It is triggered by phrases like "list meetings", "show meetings", "meeting history", or "hubspot meetings". The skill is designed to quickly surface meeting titles, times, notes, and IDs for downstream processing or display. It supports pagination and configurable limits.

How this skill works

Before running, perform a config check to ensure HubSpot credentials and scopes are valid. The skill calls the HubSpot meetings endpoint to fetch meeting objects, formats core properties (title, start/end time, notes, timestamp, id), and returns results with paging cursors when applicable. CLI flags let you change the default page size or request subsequent pages using an "after" cursor.

When to use it

When you need a quick list of upcoming or recent meetings stored in HubSpot.
When building dashboards or reports that require meeting metadata from HubSpot.
When validating meeting data during troubleshooting or QA of CRM integrations.
When synchronizing meetings with another calendar or engagement system.
When you want to paginate through large meeting histories programmatically.

Best practices

Run the pre-flight config check to verify tokens and required scopes before listing meetings.
Specify a sensible --limit to balance API usage and data needs; default returns 10 meetings.
Use the --after cursor for reliable pagination rather than increasing limit indefinitely.
Handle common HTTP errors explicitly: refresh tokens on 401, check scopes on 403, and implement retry/backoff for 429.
Parse timestamps in ISO format and convert to the desired timezone for display.

Example use cases

Quickly show the next 10 scheduled meetings for a support or sales queue.
Export a paginated list of meetings to sync with an external calendar system.
Audit recent meeting notes and durations for activity reporting.
Drive an internal assistant that answers "what meetings do I have this week?" by pulling HubSpot meeting records.
Automate a daily summary of meetings for a team standup email.

FAQ

What CLI options control output size and paging?

Use --limit to set the number of meetings returned and --after with a cursor value to fetch the next page.

What does a 403 error indicate?

A 403 typically means the app is missing the crm.objects.meetings.read scope; update app scopes and reauthorize.

What fields are returned for each meeting?

Each meeting includes id and key properties such as hs_meeting_title, hs_meeting_body (notes), hs_meeting_start_time, hs_meeting_end_time, and hs_timestamp.