Skip to content
MCP server

HubSpot MCP

Unofficial HubSpot Sales Hub server with offline cross-object queries and history

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, Windows, Linux
Runs
Locally
Version
0.3.1
Listing updated
2 days ago

About HubSpot MCP

HubSpot MCP is an open-source MCP server for sales and crm. It runs locally on your machine and is started by your AI client.

This community-built server wraps the HubSpot API and is not affiliated with HubSpot Inc. It ships alongside a CLI, hubspot-cli, and a Claude Code skill, and is aimed at managed service provider owners who run their sales in HubSpot. It authenticates with a HubSpot access token.

Beyond plain CRM calls it keeps an optional local store so queries can run across objects offline. The README shows commands for a daily nurture queue, stale contacts and deals, pipeline health with open value at risk, owner load, engagement timelines per deal, and reports on meetings that were ever in a given outcome. Read-only mode is preset on, so write tools stay hidden until you clear HUBSPOT_MCP_READ_ONLY, and HUBSPOT_NO_LOCAL_DATA turns off the local copy.

It runs over stdio by default; an HTTP mode refuses to start without a bearer token and defaults to 127.0.0.1:7777.

Install

Run in a terminal

claude mcp add hubspot-mcp --env HUBSPOT_ACCESS_TOKEN='<HUBSPOT_ACCESS_TOKEN>' --env HUBSPOT_MCP_HTTP_TOKEN='<HUBSPOT_MCP_HTTP_TOKEN>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/hubspot-v0.3.1/hubspot-mcp.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "hubspot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/hubspot-v0.3.1/hubspot-mcp.mcpb"
      ],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "<HUBSPOT_ACCESS_TOKEN>",
        "HUBSPOT_MCP_HTTP_TOKEN": "<HUBSPOT_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "hubspot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/hubspot-v0.3.1/hubspot-mcp.mcpb"
      ],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "<HUBSPOT_ACCESS_TOKEN>",
        "HUBSPOT_MCP_HTTP_TOKEN": "<HUBSPOT_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "hubspot-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/hubspot-v0.3.1/hubspot-mcp.mcpb"
      ],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "<HUBSPOT_ACCESS_TOKEN>",
        "HUBSPOT_MCP_HTTP_TOKEN": "<HUBSPOT_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "hubspot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/hubspot-v0.3.1/hubspot-mcp.mcpb"
      ],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "<HUBSPOT_ACCESS_TOKEN>",
        "HUBSPOT_MCP_HTTP_TOKEN": "<HUBSPOT_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "hubspot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/hubspot-v0.3.1/hubspot-mcp.mcpb"
      ],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "<HUBSPOT_ACCESS_TOKEN>",
        "HUBSPOT_MCP_HTTP_TOKEN": "<HUBSPOT_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Configuration

  • HUBSPOT_ACCESS_TOKENSet the HUBSPOT_ACCESS_TOKEN credential for the HubSpot MCP server.Required
  • HUBSPOT_BASE_URLBase URL for the HubSpot API. Leave the prefilled default unless your account uses a different regional or self-hosted host.
  • HUBSPOT_MCP_READ_ONLYOptional. Set to exactly 1 to expose only read-only tools and refuse any non-GET execute call. Preset to 1; clear it only when you want the agent to run the tools this switch hides.
  • HUBSPOT_NO_LOCAL_DATAOptional. Set to 1 to keep no local copy of API responses: reads go to the API, the response cache is off, and sync refuses to run. Leave blank to keep the local store.
  • HUBSPOT_OWNER_EMAILEmail address that `--owner me` resolves to when git config user.email is not set. Leave blank to name the owner on each call.
  • HUBSPOT_MCP_HTTP_TOKENBearer token required by `hubspot-mcp --transport http`; unused by the default stdio transport.
  • HUBSPOT_USER_AGENTOverrides the User-Agent the CLI sends on HubSpot requests.
  • PRINTING_PRESS_CLIENT_PROFILEBinds this MCP server to one tenant-gated client profile, so every call answers for that customer. Leave blank to use the profile configured as default_client_profile.

What it does

Offline cross-object queries
A local store lets queries span contacts, deals and engagements without calling the API each time.
Property change history
Reports on how properties changed over time, such as meetings once marked scheduled.
Sales hygiene reports
Commands cover stale contacts and deals, pipeline health and owner load.
Read-only by default
Write tools are hidden until the read-only switch is cleared.
Optional HTTP mode
Remote agents can connect over HTTP with a required bearer token.
Wide agent support
The README covers Claude Desktop, ChatGPT desktop, Codex, Claude Code, Copilot and Gemini CLI.

Good for

  • Build a daily list of people to call
  • Find contacts or deals that have gone cold
  • Check open pipeline value and idle days per stage
  • See every call, email and meeting on a deal
  • Spot sales reps who carry too many deals

Pricing

Open source

Free and open source per the README; a HubSpot account is required

HubSpot MCP FAQ

Is it official?

No. The README calls it unofficial and community-built, not affiliated with or endorsed by HubSpot.

What credential does it need?

A HubSpot access token set as HUBSPOT_ACCESS_TOKEN.

Can it change my CRM?

Only if you clear the read-only setting, which is preset to on.

Does it work with ChatGPT on the web?

No. The README says the web version needs a remote server, which is not supported yet.

Is HubSpot MCP free?

Yes. HubSpot MCP is open source, so you can use and self-host it for free.

How do I add HubSpot MCP to Claude Code?

Run this command in your terminal: claude mcp add hubspot-mcp --env HUBSPOT_ACCESS_TOKEN='<HUBSPOT_ACCESS_TOKEN>' --env HUBSPOT_MCP_HTTP_TOKEN='<HUBSPOT_MCP_HTTP_TOKEN>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/hubspot-v0.3.1/hubspot-mcp.mcpb

What are the best alternatives to HubSpot MCP?

The closest alternatives to HubSpot MCP are Calven, CompanyData, MisarReach MCP Server, NeuralVerge and ZUUZ.

Alternatives to HubSpot MCP

  1. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  2. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data
  3. Find, enrich and score B2B leads and run outreach sequences from an AI assistant

    • 31 tools
    • Remote
    • Freemium
    • 1 GitHub star
    • Sales and CRM
  4. NeuralVerge

    MCP server

    Structured, source-tagged business and people data from 300+ sources for agents

    • 200 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Web search and scraping
  5. ZUUZ

    MCP server

    Ask Claude or ChatGPT about deals and follow-ups ZUUZ finds in sales email for MSPs

    Not checked yet
    • Remote
    • Free trial
    • Sales and CRM
  6. Fuse

    MCP server

    Hosted MCP server for B2B prospecting, contact enrichment, buying signals and outreach

    Not checked yet
    • Remote
    • Freemium
    • Sales and CRM