Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
skillhq avatar

Hubspot

skillhq/hubspot

  • 6 installs
  • Updated January 29, 2026
  • skillhq/hubspot

Helps with ai & agent building tasks.

About

hubspot is a Claude Code skill for ai & agent building. It helps solo builders move faster with AI-assisted development.

  • hubspot
  • AI & Agent Building
  • AI-coding skill

Hubspot by the numbers

  • 6 all-time installs (skills.sh)
  • Ranked #12,756 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
  • Data as of Jul 27, 2026 (Skillselion catalog sync)
npx skills add https://github.com/skillhq/hubspot --skill hubspot

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs6
Last updatedJanuary 29, 2026
Repositoryskillhq/hubspot ↗

What it does

Helps with ai & agent building tasks.

Files

SKILL.mdMarkdownGitHub ↗

HubSpot CLI

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

When to Use

Use this skill when the user:

  • Asks to look up a contact, company, or deal in HubSpot
  • Wants to search HubSpot CRM for specific records
  • Needs to create or update contacts, deals, or companies
  • Asks about deal pipelines or stages
  • Wants to view or create notes/tasks
  • Needs to check associations between CRM objects

Install

npm install -g @skillhq/hubspot

Authentication

First-time setup requires a Private App access token from HubSpot:

1. Go to HubSpot Settings > Integrations > Private Apps (under "Legacy Apps") 2. Create a new Private App with required scopes 3. Run hubspot auth and paste the access token (starts with pat-)

hubspot auth

Commands

Auth & Status

hubspot auth                    # Configure access token
hubspot check                   # Verify authentication
hubspot whoami                  # Show portal info

Contacts

hubspot contacts                          # List contacts
hubspot contacts -n 50                    # List 50 contacts
hubspot contact <id>                      # Get contact details
hubspot contact-search "john"             # Search contacts
hubspot contact-create --email x@y.com --firstname John
hubspot contact-update <id> --phone "555-1234"

Companies

hubspot companies                         # List companies
hubspot company <id>                      # Get company details
hubspot company-search "acme"             # Search companies

Deals

hubspot deals                             # List deals
hubspot deals --pipeline <id>             # Filter by pipeline ID
hubspot deals --pipeline-name "WCP"       # Filter by pipeline name (fuzzy match)
hubspot deals --stage <id>                # Filter by stage ID
hubspot deal <id>                         # Get deal details
hubspot deal-search "enterprise"          # Search deals
hubspot pipelines                         # List pipelines and stages
hubspot pipelines --search "wallet"       # Search pipelines by name

Tickets

hubspot tickets                           # List tickets
hubspot ticket <id>                       # Get ticket details
hubspot ticket-search "issue"             # Search tickets

Notes & Tasks

hubspot notes contacts <id>               # List notes for contact
hubspot note-create contacts <id> "Note text"
hubspot tasks                             # List tasks
hubspot task <id>                         # Get task details
hubspot task-create --subject "Follow up" --due "2024-12-31" --priority HIGH

Associations

hubspot associations contacts <id> companies    # List company associations
hubspot associate contacts <id1> deals <id2>    # Create association

Output Formats

All commands support:

  • Default: Colored terminal output
  • --json: JSON output for scripting (clean, pipeable to jq)
  • --markdown: Markdown table output
hubspot contacts --json              # JSON format
hubspot deals --markdown             # Markdown tables

JSON Output & Piping

JSON output is clean and can be piped directly to jq:

# Get pipeline ID for first deal
hubspot deals --json | jq '.results[0].pipeline'

# Filter deals by pipeline and extract names
hubspot deals --pipeline 831085590 --json | jq '.results[].dealname'

# Get contact emails
hubspot contacts --json | jq -r '.results[].email'

# Count deals in a stage
hubspot deals --pipeline 831085590 --stage 1231737429 --json | jq '.results | length'

Note: Pagination info is included in the JSON response as .paging.next.after.

Pagination

List commands support pagination:

hubspot contacts -n 50               # Limit to 50 results
hubspot contacts --after <cursor>    # Next page using cursor

Examples

Check authentication:

hubspot check

Search for a contact:

hubspot contact-search "john@example.com"

View deal pipeline stages:

hubspot pipelines

Create a task:

hubspot task-create --subject "Schedule demo" --priority HIGH --due "2024-12-15"

Limitations

  • Views not supported: The CLI cannot filter by HubSpot saved view IDs from URLs
  • When given a view URL like /views/57091019/, you must manually identify which pipeline the view filters and use --pipeline <id> instead
  • Use hubspot pipelines to list all pipelines and their IDs

View URL Workaround

If given a HubSpot view URL like https://app.hubspot.com/contacts/.../views/57091019/list:

1. Ask the user which pipeline it filters 2. Open the view in browser to identify the pipeline 3. Use hubspot pipelines and match by name

The view ID in the URL is not a pipeline ID - they are different concepts in HubSpot.

Notes

  • IDs are HubSpot object IDs (numeric strings)
  • Dates use ISO format (YYYY-MM-DD or full ISO timestamp)
  • Priority values: LOW, MEDIUM, HIGH
  • Task status values: NOT_STARTED, IN_PROGRESS, COMPLETED

Related skills

mattpocockSetup Matt Pocock SkillsScaffold the per-repo configuration that Matt Pocock’s engineering agent skills rely on so they understand the issue tracker, triage labels, and domain documentation la495k196kopen.feishu.cnLark AppsConnect Claude, Cursor or custom agents directly to Lark (Feishu) for messaging, document automation, approval workflows and enterprise data access.402kjuliusbrusseeCavemanSlash token usage by roughly 75% while keeping every technical detail intact when working with Claude Code, Cursor or similar agents.391k94.7klarksuiteLark Skill MakerQuickly turn any Lark/Feishu OpenAPI call or multi-step workflow into a reusable agent skill with its own SKILL.md.386k16kxixu-meRunning Claude Code Via Litellm CopilotRun Claude Code at a fraction of the cost by routing requests through LiteLLM to the GitHub Copilot Chat API.270k72runcomfy-comCodex PetGenerate a complete Codex Pet spritesheet and metadata from one reference image without needing an OpenAI key or Codex Pro.246k10
AI & Agent Buildingagents
Browse by category
AI & AgentsFrontend & DesignBackend & DataDev ToolsAutomationTesting & ReviewSecurityMonitoring & CloudDocs & Planning
Design & frontend
Design systemsAnimation & motionAccessibility (a11y)CSS & TailwindUI designUXDesign to codeshadcn/uiLanding pagesBest design skills
Most searched skills
find-skillscavemanfrontend-designbrainstormingsystematic-debuggingstop-slopemil-design-engui-ux-pro-maxkarpathy-guidelinesweb-design-guidelinesreact-best-practicesgrill-meimprovemicrosoft-foundryagent-browser
Browse all listings
All agent skillsAll MCP serversAll marketplacesAll plugins

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.