# HubSpot MCP

> HubSpot MCP is an open-source MCP server for sales and crm. Unofficial HubSpot Sales Hub server with offline cross-object queries and history. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Windows, Linux, CLI
- **Repository:** https://github.com/servosity/msp-skills/tree/HEAD/skills/hubspot
- **MCP Registry name:** io.github.Servosity/hubspot-mcp
- **Categories:** sales and CRM
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## 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

- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MisarReach MCP Server](https://ai-powered.com/mcp/misarreach-mcp-server): MisarReach MCP Server is a freemium MCP server for sales and crm.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [ZUUZ](https://ai-powered.com/mcp/zuuz): ZUUZ is an MCP server for sales and crm.
- [Fuse](https://ai-powered.com/mcp/fuse-2): Fuse is a freemium MCP server for sales and crm.
- [Gender-API.com](https://ai-powered.com/mcp/gender-api-com): Gender-API.com is a freemium MCP server for analytics and data.
- [Dialvett: Bulk Phone Number Validator & Carrier Lookup](https://ai-powered.com/mcp/dialvett-bulk-phone-number-validator-and-carrier-lookup): Dialvett: Bulk Phone Number Validator & Carrier Lookup is a paid MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/hubspot-mcp
