@cli4ai/hubspot

HubSpot CRM CLI tool for managing contacts, deals, and companies.

Installation

cli4ai add hubspot

Setup

1. Create a HubSpot Private App

1. Go to HubSpot → Settings (gear icon) → Integrations → Private Apps
   • Or visit: https://app.hubspot.com/private-apps/{your-hub-id}
2. Click Create a private app
3. Give it a name (e.g., "cli4ai Integration")
4. Go to the Scopes tab and enable:
   • crm.objects.contacts.read
   • crm.objects.contacts.write
   • crm.objects.deals.read
   • crm.objects.deals.write
   • crm.objects.companies.read
5. Click Create app → Continue Creating
6. Copy the Access Token

Note: You must be a super admin in HubSpot to create private apps.

2. Configure the Token

cli4ai secrets set HUBSPOT_ACCESS_TOKEN "pat-na1-xxxxx"

Commands

Contacts

# List contacts
cli4ai run hubspot contacts
cli4ai run hubspot contacts 20          # Get 20 contacts

# Get a specific contact
cli4ai run hubspot contact 12345        # By ID
cli4ai run hubspot contact user@example.com  # By email

# Create a contact
cli4ai run hubspot contact-create user@example.com John Doe

# Update a contact
cli4ai run hubspot contact-update 12345 '{"phone":"+1234567890"}'

# Delete a contact
cli4ai run hubspot contact-delete 12345

Deals

# List deals
cli4ai run hubspot deals
cli4ai run hubspot deals 20             # Get 20 deals

# Get a specific deal
cli4ai run hubspot deal 12345

# Create a deal
cli4ai run hubspot deal-create "New Deal"
cli4ai run hubspot deal-create "Big Deal" closedwon 50000

# Update a deal
cli4ai run hubspot deal-update 12345 '{"amount":"75000"}'

# Delete a deal
cli4ai run hubspot deal-delete 12345

Companies

# List companies
cli4ai run hubspot companies

# Get a specific company
cli4ai run hubspot company 12345

Search

# Search across CRM objects
cli4ai run hubspot search contacts "john@example.com"
cli4ai run hubspot search deals "enterprise"
cli4ai run hubspot search companies "acme"

MCP Server

Use HubSpot as an MCP server for AI agents:

cli4ai start hubspot

Configure in Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "hubspot": {
      "command": "cli4ai",
      "args": ["start", "hubspot"]
    }
  }
}

Output Format

All commands output JSON for AI consumption:

{
  "contacts": [
    {
      "id": "12345",
      "email": "john@example.com",
      "name": "John Doe",
      "company": "Acme Inc",
      "lifecyclestage": "customer"
    }
  ],
  "count": 1,
  "hasMore": false
}

Links

• HubSpot CRM API Docs
• Private Apps Guide