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. 125 installs a week from npm. Last commit 13 Sep 2026.

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

Installs per day peak 45 · avg 23 · -12% w/w
a month agotoday
125
Installs / week
npm · @mindstone/mcp-server-hubspot
12
Stars
1 open issues
13 Sep 2026
Last commit
0 releases in 90 days
License
TypeScript

What the code does

We read the source, 21 h ago · rules 3dff92dd89df

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 -- npx -y @mindstone/mcp-server-hubspot
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mcp-server-hubspot": {
      "args": [
        "-y",
        "@mindstone/mcp-server-hubspot"
      ],
      "command": "npx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.mcp-server-hubspot]
command = "npx"
args = ["-y", "@mindstone/mcp-server-hubspot"]
.cursor/mcp.json
{
  "mcpServers": {
    "mcp-server-hubspot": {
      "args": [
        "-y",
        "@mindstone/mcp-server-hubspot"
      ],
      "command": "npx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "mcp-server-hubspot": {
      "args": [
        "-y",
        "@mindstone/mcp-server-hubspot"
      ],
      "command": "npx"
    }
  }
}

This one needs environment variables set before it will start: HUBSPOT_CONFIG_DIR (Directory containing accounts.json and credentials/*.token.json), HUBSPOT_ACCOUNT_EMAIL (Account selector — one MCP process per HubSpot account), MCP_WORKSPACE_PATH (Workspace root for local file tools (required only when invoking upload/attach tools)), HUBSPOT_CLIENT_ID (HubSpot OAuth client ID), HUBSPOT_CLIENT_SECRET (HubSpot OAuth client secret), 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)). The author declared them in the registry entry; get the values from the project itself.

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.

50 installs/wk local only
Attio MCP Server
by kesslerio

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

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

256 installs/wk local only
Swsd
by mikimatsub

MCP server for SolarWinds Service Desk tickets, catalog, knowledge, ITSM operations, and workflows.

128 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 125 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 with the file path 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 125 times in the last week. Week over week that is -12%. 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?
We cannot say either way: written in TypeScript, 12 stars on GitHub and 1 open issue, but we could not determine the licence, and without one the code is not open source by default.