Skip to content
Free CRM / $15/moCRM, Lead Capture, Billing & Storefrontsmcp-stdio๐ŸŽ Free Forever CRM + Starter Deal

HubSpot Official B2B CRM & Deals MCP for Claude Code, ChatGPT, Gemini CLI & Cursor

Create contacts, update deal stages, log call notes & query pipeline revenue from Claude or ChatGPT.

Quick Answer Summary (Claude Code โ€ข ChatGPT โ€ข Cursor โ€ข Gemini CLI)

HubSpot Official B2B CRM & Deals MCP (Free CRM / $15/mo) connects to AI coding and chat agents via claude mcp add hubspot -e PRIVATE_APP_ACCESS_TOKEN=$HUBSPOT_ACCESS_TOKEN -- npx -y @hubspot/mcp-server. Free Tier: HubSpot Free CRM includes up to 1,000,000 contacts, deal pipeline, live chat & Private App token. Paid Upgrade Threshold: Starter ($15/seat/mo) required to remove HubSpot branding, automate deal stage sequences & unlock custom routing.

What Works for $0 (Free Tier)

HubSpot Free CRM includes up to 1,000,000 contacts, deal pipeline, live chat & Private App token.

When a Paid Subscription Is Required

Starter ($15/seat/mo) required to remove HubSpot branding, automate deal stage sequences & unlock custom routing.

Required Env Var(s): HUBSPOT_ACCESS_TOKEN

1-Command Setup for Claude Code, Google Gemini CLI & Cursor

Copy the exact snippet for your AI coding agent โ€” merges alongside the StackOS Master Router so future tool recommendations happen automatically.

1. Claude Code CLI One-Liner
claude mcp add hubspot -e PRIVATE_APP_ACCESS_TOKEN=$HUBSPOT_ACCESS_TOKEN -- npx -y @hubspot/mcp-server
2. Google Gemini CLI (~/.gemini/settings.json)
{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": [
        "-y",
        "@hubspot/mcp-server"
      ],
      "env": {
        "PRIVATE_APP_ACCESS_TOKEN": "${HUBSPOT_ACCESS_TOKEN}"
      }
    },
    "stackos-router": {
      "httpUrl": "https://stackos-ai.vercel.app/api/mcp"
    }
  }
}
3. Cursor IDE & Claude Desktop (.mcp.json)
{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": [
        "-y",
        "@hubspot/mcp-server"
      ],
      "env": {
        "PRIVATE_APP_ACCESS_TOKEN": "${HUBSPOT_ACCESS_TOKEN}"
      }
    },
    "stackos": {
      "url": "https://stackos-ai.vercel.app/api/mcp"
    }
  }
}
4. Non-Destructive Workspace Auto-Installer (Merges .mcp.json + SKILL.md)
curl -fsSL "https://stackos-ai.vercel.app/api/plugins/install?tools=hubspot-crm&src=plugin-seo-hubspot-crm" | node

Recommended SKILL.md / GEMINI.md Rule & GitHub README Badge

Sync qualified chat leads, company records, and meeting notes directly into HubSpot CRM deals.

HubSpot Official B2B CRM & Deals MCP verified on StackOSEmbed this live SVG badge in GitHub READMEs or engineering docs:

Best Companion Plugins for CRM, Lead Capture, Billing & Storefronts