mcpbeat Sign in

HubSpot MCP Server

local only

HubSpot runs on your own machine — the client starts it, so there is no endpoint to ping. 128 installs a week from npm. Last commit 2 Nov 2026.

HubSpot CRM: contacts, deals, tickets, line items, properties, marketing, files, workflows, threads

Installs per day peak 48 · avg 14 · +151% w/w
a month agotoday
128
Installs / week
npm · @mindstone/mcp-server-hubspot
14
Stars
2 open issues
2 Nov 2026
Last commit
2 releases in 90 days
FSL-1.1-MIT
License
TypeScript

What the code does

We read the source, 22 h ago · rules 995398eba69f

A tool parameter reaches a dangerous call

A value the model can set ends up inside a file or shell call. That is not a flaw by itself — for a terminal server it is the job — but it is where things go wrong when it is not.

A tool parameter reaches a file or shell call replace_workspace_document.document_id → connectors/pandadoc/src/tools/documents.ts:891
          fs.writeFileSync(outFd, pdfBuffer);
Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Runs an external command connectors/office/src/index.ts:403
    const child = spawn(process.execPath, [script], {
  if (isUnder(resolvedAbs, sshDir)) return { hit: true, reason: '~/.ssh/** is sensitive' };
Page loads a third-party script connectors/office/src/addin/taskpane.html:10
  <script src="https://appsforoffice.microsoft.com/lib/1.1/hosted/office.js"></script>
    const entries = fs.readdirSync(workspacePath, { withFileTypes: true });

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

A tool parameter here reaches a dangerous call

That is not a flaw by itself — but it is where things go wrong when it is not the job. We re-read this code on every release. Watch it and you hear from us the day another one appears.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add mcp-server-hubspot -e 'HUBSPOT_CONFIG_DIR=<HUBSPOT_CONFIG_DIR>' -e 'HUBSPOT_ACCOUNT_EMAIL=<HUBSPOT_ACCOUNT_EMAIL>' -e 'HUBSPOT_CLIENT_ID=<HUBSPOT_CLIENT_ID>' -e 'HUBSPOT_CLIENT_SECRET=<HUBSPOT_CLIENT_SECRET>' -- npx -y @mindstone/mcp-server-hubspot
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mcp-server-hubspot": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-hubspot"
      ],
      "env": {
        "HUBSPOT_ACCOUNT_EMAIL": "<HUBSPOT_ACCOUNT_EMAIL>",
        "HUBSPOT_CLIENT_ID": "<HUBSPOT_CLIENT_ID>",
        "HUBSPOT_CLIENT_SECRET": "<HUBSPOT_CLIENT_SECRET>",
        "HUBSPOT_CONFIG_DIR": "<HUBSPOT_CONFIG_DIR>"
      }
    }
  }
}
~/.codex/config.toml
[mcp_servers.mcp-server-hubspot]
command = "npx"
args = ["-y", "@mindstone/mcp-server-hubspot"]
env = { HUBSPOT_CONFIG_DIR = "<HUBSPOT_CONFIG_DIR>", HUBSPOT_ACCOUNT_EMAIL = "<HUBSPOT_ACCOUNT_EMAIL>", HUBSPOT_CLIENT_ID = "<HUBSPOT_CLIENT_ID>", HUBSPOT_CLIENT_SECRET = "<HUBSPOT_CLIENT_SECRET>" }
.cursor/mcp.json
{
  "mcpServers": {
    "mcp-server-hubspot": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-hubspot"
      ],
      "env": {
        "HUBSPOT_ACCOUNT_EMAIL": "<HUBSPOT_ACCOUNT_EMAIL>",
        "HUBSPOT_CLIENT_ID": "<HUBSPOT_CLIENT_ID>",
        "HUBSPOT_CLIENT_SECRET": "<HUBSPOT_CLIENT_SECRET>",
        "HUBSPOT_CONFIG_DIR": "<HUBSPOT_CONFIG_DIR>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "mcp-server-hubspot": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-hubspot"
      ],
      "env": {
        "HUBSPOT_ACCOUNT_EMAIL": "<HUBSPOT_ACCOUNT_EMAIL>",
        "HUBSPOT_CLIENT_ID": "<HUBSPOT_CLIENT_ID>",
        "HUBSPOT_CLIENT_SECRET": "<HUBSPOT_CLIENT_SECRET>",
        "HUBSPOT_CONFIG_DIR": "<HUBSPOT_CONFIG_DIR>"
      }
    }
  }
}

Put your own values in place of <HUBSPOT_CONFIG_DIR> (Directory containing accounts.json and credentials/*.token.json), <HUBSPOT_ACCOUNT_EMAIL> (Account selector — one MCP process per HubSpot account), <HUBSPOT_CLIENT_ID> (HubSpot OAuth client ID), <HUBSPOT_CLIENT_SECRET> (HubSpot OAuth client secret). The author’s registry entry marks them as required.

Optional settings from the registry entry, left out of the block above: MCP_WORKSPACE_PATH (Workspace root for local file tools (required only when invoking upload/attach tools)), HUBSPOT_SOURCE_LABEL (Source attribution label applied to new records), HUBSPOT_DISABLE_REFRESH (Set to 1 to disable token refresh on this surface (use on cloud so desktop remains the sole refresh authority)), HUBSPOT_ALLOW_CLOUD_REFRESH (Set to 1 to allow refresh on the cloud surface even when HUBSPOT_DISABLE_REFRESH=1 (escape hatch)), HUBSPOT_REQUEST_TIMEOUT_MS (Outbound HTTP request timeout in milliseconds (max 300000 = 5 min)), HUBSPOT_REFRESH_LOCK_STALE_MS (Stale-lock detection threshold for the credential refresh mutex (advanced)).

Alternatives to HubSpot

same job, measured the same way
Rocket Plus MCP
by crypto-goatz

56+ AI tools for CRM, content, workflows, SkillForge & marketing automation.

37 installs/wk local only
Attio MCP Server
by kesslerio

AI-powered Attio CRM access. Manage contacts, companies, deals, tasks, notes and workflows.

962 installs/wk local only
ServiceAgent CRM
by gaufire

Search CRM contacts, deals, tasks, appointments, calls and workflows with workspace-scoped OAuth.

answering
Pencil
by pencilink

Manage tasks, projects, roadmaps, files, meetings, and team workflows with AI tools.

answering
weave
by grunion-ai

Connected tables, relations, workflows and markdown documents in one SQLite file, over MCP.

local only
D50 AI — Sales, Marketing & Hiring Automation
by d50

246 tools to run sales, marketing & hiring: CRM, leads, AI calling, content, recruiting & SEO.

answering
Jira
by waystation

Track issues, manage projects, and streamline workflows in Jira.

answering
Atlassian Jira
by mcparmory

Create, search, and manage issues, projects, and team workflows

277 installs/wk local only

HubSpot — questions

Answers built from our own checks of this server.

Why is there no uptime for HubSpot?
HubSpot runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package @mindstone/mcp-server-hubspot was installed 128 times last week.
How do I connect HubSpot?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls @mindstone/mcp-server-hubspot straight from npm; nothing to host, nothing to sign up for.
How many people use HubSpot?
The npm package @mindstone/mcp-server-hubspot was installed 128 times in the last week. Week over week that is +151%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is HubSpot open source?
No, and the distinction matters: its licence is declared as FSL-1.1-MIT. That makes it source-available — you can read the code, but the terms are the author's own, not one of the recognised open-source licences. Read them before you build on it.