technickai/hubspot

HubSpot 🟠

Read HubSpot CRM data from the REST API.

Setup

Create or use a HubSpot private app token, then configure it as HUBSPOT_API_KEY in OpenClaw.

Recommended scopes for this skill:

• crm.objects.contacts.read
• crm.objects.contacts.write (needed for create/delete contact operations)
• crm.objects.deals.read
• crm.schemas.deals.read

What Users Ask

• "Look up this person in HubSpot"
• "Search HubSpot for [name or email]"
• "Show me recent deals"
• "What stage is this deal in?"
• "List the HubSpot deal stages"
• "Open this contact or deal by ID"

Commands

• hubspot contacts [query] [--limit N]
• hubspot contact <contact_id>
• hubspot deals [query] [--limit N]
• hubspot deal <deal_id>
• hubspot stages
• hubspot create-contact --email <email> [--first NAME] [--last NAME] [--phone N] [--company NAME]
• hubspot delete-contact <contact_id>

Capabilities

• Search contacts by free text
• Fetch a contact by HubSpot ID
• Search deals by free text
• Fetch a deal by HubSpot ID
• Resolve deal stage IDs to readable labels
• List all configured deal pipelines and stages
• Create a contact for testing or workflow setup
• Delete a contact by HubSpot ID

Notes

• Owner lookup is not included because many HubSpot tokens do not have the extra scopes required for the owners API.
• Deal stage labels come from the pipelines API, so stage output stays readable instead of showing only internal IDs.
• Create/delete commands only work when the private app has crm.objects.contacts.write.