hubspot-list-meetings_skill

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.