HubSpot

Name: HubSpot
Author: mindstone

Community

MCP server by mindstone · updated 7 days ago · ★ 13 · 106 downloads a week

Score 68

HubSpot CRM: contacts, deals, tickets, line items, properties, marketing, files, workflows, threads HubSpot is a community project by mindstone, not verified by a company domain.

Install Add to Cursor Add to VS Code GitHub

Yours? Claim it

Works withClaude Code Claude Desktop Cursor Codex Gemini CLI VS Code Windsurf Antigravity CLI

Maintenance

Last commit 7 days ago

Licence

No licence found, so reuse rights are unclear

Quality

Clear description, published package or server URL, original repository

Security

Not checked yet. What we check

What you need

Setting	Needed	What it is
`HUBSPOT_CONFIG_DIR`Environment variable	Required	Directory containing accounts.json and credentials/*.token.json
`HUBSPOT_ACCOUNT_EMAIL`Environment variable	Required	Account selector — one MCP process per HubSpot account
`HUBSPOT_CLIENT_ID`Environment variable	Required	HubSpot OAuth client ID
`HUBSPOT_CLIENT_SECRET`Environment variable, secret	Required	HubSpot OAuth client secret
`MCP_WORKSPACE_PATH`Environment variable	Optional	Workspace root for local file tools (required only when invoking upload/attach tools)
`HUBSPOT_SOURCE_LABEL`Environment variable	Optional	Source attribution label applied to new records Default: `HubSpot MCP`
`HUBSPOT_DISABLE_REFRESH`Environment variable	Optional	Set to 1 to disable token refresh on this surface (use on cloud so desktop remains the sole refresh authority)
`HUBSPOT_ALLOW_CLOUD_REFRESH`Environment variable	Optional	Set to 1 to allow refresh on the cloud surface even when HUBSPOT_DISABLE_REFRESH=1 (escape hatch)
`HUBSPOT_REQUEST_TIMEOUT_MS`Environment variable	Optional	Outbound HTTP request timeout in milliseconds (max 300000 = 5 min) Default: `60000`
`HUBSPOT_REFRESH_LOCK_STALE_MS`Environment variable	Optional	Stale-lock detection threshold for the credential refresh mutex (advanced)

From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.

Install HubSpot

Built from the published package, never by AI

claude mcp add hubspot -e HUBSPOT_CONFIG_DIR=YOUR_HUBSPOT_CONFIG_DIR -e HUBSPOT_ACCOUNT_EMAIL=YOUR_HUBSPOT_ACCOUNT_EMAIL -e HUBSPOT_CLIENT_ID=YOUR_HUBSPOT_CLIENT_ID -e HUBSPOT_CLIENT_SECRET=YOUR_HUBSPOT_CLIENT_SECRET -- npx -y @mindstone/mcp-server-hubspot

Run in your terminal. Add --scope user to use it in every project.

Step-by-step: install HubSpot in Claude Code

{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-hubspot"
      ],
      "env": {
        "HUBSPOT_CONFIG_DIR": "YOUR_HUBSPOT_CONFIG_DIR",
        "HUBSPOT_ACCOUNT_EMAIL": "YOUR_HUBSPOT_ACCOUNT_EMAIL",
        "HUBSPOT_CLIENT_ID": "YOUR_HUBSPOT_CLIENT_ID",
        "HUBSPOT_CLIENT_SECRET": "YOUR_HUBSPOT_CLIENT_SECRET"
      }
    }
  }
}

Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.

Step-by-step: install HubSpot in Claude Desktop

{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-hubspot"
      ],
      "env": {
        "HUBSPOT_CONFIG_DIR": "YOUR_HUBSPOT_CONFIG_DIR",
        "HUBSPOT_ACCOUNT_EMAIL": "YOUR_HUBSPOT_ACCOUNT_EMAIL",
        "HUBSPOT_CLIENT_ID": "YOUR_HUBSPOT_CLIENT_ID",
        "HUBSPOT_CLIENT_SECRET": "YOUR_HUBSPOT_CLIENT_SECRET"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).

Step-by-step: install HubSpot in Cursor

{
  "servers": {
    "hubspot": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-hubspot"
      ],
      "env": {
        "HUBSPOT_CONFIG_DIR": "YOUR_HUBSPOT_CONFIG_DIR",
        "HUBSPOT_ACCOUNT_EMAIL": "YOUR_HUBSPOT_ACCOUNT_EMAIL",
        "HUBSPOT_CLIENT_ID": "YOUR_HUBSPOT_CLIENT_ID",
        "HUBSPOT_CLIENT_SECRET": "YOUR_HUBSPOT_CLIENT_SECRET"
      }
    }
  }
}

Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".

Step-by-step: install HubSpot in VS Code

codex mcp add hubspot --env HUBSPOT_CONFIG_DIR=YOUR_HUBSPOT_CONFIG_DIR --env HUBSPOT_ACCOUNT_EMAIL=YOUR_HUBSPOT_ACCOUNT_EMAIL --env HUBSPOT_CLIENT_ID=YOUR_HUBSPOT_CLIENT_ID --env HUBSPOT_CLIENT_SECRET=YOUR_HUBSPOT_CLIENT_SECRET -- npx -y @mindstone/mcp-server-hubspot

Step-by-step: install HubSpot in Codex

{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-hubspot"
      ],
      "env": {
        "HUBSPOT_CONFIG_DIR": "YOUR_HUBSPOT_CONFIG_DIR",
        "HUBSPOT_ACCOUNT_EMAIL": "YOUR_HUBSPOT_ACCOUNT_EMAIL",
        "HUBSPOT_CLIENT_ID": "YOUR_HUBSPOT_CLIENT_ID",
        "HUBSPOT_CLIENT_SECRET": "YOUR_HUBSPOT_CLIENT_SECRET"
      }
    }
  }
}

Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).

Step-by-step: install HubSpot in Antigravity CLI

gemini mcp add hubspot npx -y @mindstone/mcp-server-hubspot

Gemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.

Step-by-step: install HubSpot in Gemini CLI

MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the hubspot block.

Weekly newsletter

Like HubSpot? Get the best new MCP servers every week

The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.

Alternatives to HubSpot

All alternatives →

mcp-server HeyPuter

Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more

ACA Remote 44k

Agent-Native ContentBuilderIO

Open-source Obsidian for MDX - edit local docs with agent assistance

AAA Remote 7.4k

Computerpollinations

A private persistent computer: files and a bash shell that survive between runs.

AAA Remote 5.2k

Desktop Commanderwonderwhy-er

MCP server for terminal commands, file operations, and process management

AAA Local 196k/wk

Eve vercel

Filesystem-first framework for durable backend AI agents that run anywhere.

AAA Local 839k/wk

Global WebMCP-org

W3C Web Model Context Protocol (WebMCP) API polyfill. Let AI agents like Claude, ChatGPT, and Gemini interact with your website via document.modelContext.

AAB Local 48k/wk

HubSpot vs mcp-server HubSpot vs Agent-Native Content HubSpot vs Computer

HubSpot: common questions

How do I install HubSpot?

In Claude Code run claude mcp add hubspot -e HUBSPOT_CONFIG_DIR=YOUR_HUBSPOT_CONFIG_DIR -e HUBSPOT_ACCOUNT_EMAIL=YOUR_HUBSPOT_ACCOUNT_EMAIL -e HUBSPOT_CLIENT_ID=YOUR_HUBSPOT_CLIENT_ID -e HUBSPOT_CLIENT_SECRET=YOUR_HUBSPOT_CLIENT_SECRET -- npx -y @mindstone/mcp-server-hubspot. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.

Is HubSpot the official server?

HubSpot is a community project by mindstone, not verified by a company domain.

Is HubSpot free?

The code is published under the NOASSERTION licence. The service it connects to may have its own pricing.

Is HubSpot safe to use?

It scores 68 of 100. Grades: maintenance A, licence F, quality C. The security check has not run for it yet. Review the code before you install. How grades work.

What are alternatives to HubSpot?

Similar MCP servers: mcp-server, Agent-Native Content, Computer, Desktop Commander.

Does HubSpot work with ChatGPT?

Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.