HubSpot
Rank #9,468io.github.mindstone/mcp-server-hubspot
HubSpot CRM: contacts, deals, tickets, line items, properties, marketing, files, workflows, threads
HubSpot is a Model Context Protocol (MCP) server published by mindstone. It ranks #9,468 of 115,591 servers tracked on MCP Toplist, and its repository has 10 GitHub stars. HubSpot is listed on Official MCP, with 5 tracked versions. It was first listed on May 21, 2026 and most recently updated on Aug 8, 2026.
Ranks ahead of 106,123 of 115,591 servers on MCP Toplist.
Use HubSpot
Requires user-supplied configuration before first use — typically an API key, token or connection string set via environment variables.
claude mcp add mcp-server-hubspot -e "HUBSPOT_CONFIG_DIR=<your HUBSPOT_CONFIG_DIR>" -e "HUBSPOT_ACCOUNT_EMAIL=<your HUBSPOT_ACCOUNT_EMAIL>" -e "MCP_WORKSPACE_PATH=<your MCP_WORKSPACE_PATH>" -e "HUBSPOT_CLIENT_ID=<your HUBSPOT_CLIENT_ID>" -e "HUBSPOT_CLIENT_SECRET=<your HUBSPOT_CLIENT_SECRET>" -e "HUBSPOT_SOURCE_LABEL=<your HUBSPOT_SOURCE_LABEL>" -e "HUBSPOT_DISABLE_REFRESH=<your HUBSPOT_DISABLE_REFRESH>" -e "HUBSPOT_ALLOW_CLOUD_REFRESH=<your HUBSPOT_ALLOW_CLOUD_REFRESH>" -e "HUBSPOT_REQUEST_TIMEOUT_MS=<your HUBSPOT_REQUEST_TIMEOUT_MS>" -e "HUBSPOT_REFRESH_LOCK_STALE_MS=<your HUBSPOT_REFRESH_LOCK_STALE_MS>" -- npx -y @mindstone/mcp-server-hubspotReplace each placeholder with your own value before saving.
[mcp_servers.mcp-server-hubspot]
command = "npx"
args = ["-y", "@mindstone/mcp-server-hubspot"]
[mcp_servers.mcp-server-hubspot.env]
HUBSPOT_CONFIG_DIR = "<your HUBSPOT_CONFIG_DIR>"
HUBSPOT_ACCOUNT_EMAIL = "<your HUBSPOT_ACCOUNT_EMAIL>"
MCP_WORKSPACE_PATH = "<your MCP_WORKSPACE_PATH>"
HUBSPOT_CLIENT_ID = "<your HUBSPOT_CLIENT_ID>"
HUBSPOT_CLIENT_SECRET = "<your HUBSPOT_CLIENT_SECRET>"
HUBSPOT_SOURCE_LABEL = "<your HUBSPOT_SOURCE_LABEL>"
HUBSPOT_DISABLE_REFRESH = "<your HUBSPOT_DISABLE_REFRESH>"
HUBSPOT_ALLOW_CLOUD_REFRESH = "<your HUBSPOT_ALLOW_CLOUD_REFRESH>"
HUBSPOT_REQUEST_TIMEOUT_MS = "<your HUBSPOT_REQUEST_TIMEOUT_MS>"
HUBSPOT_REFRESH_LOCK_STALE_MS = "<your HUBSPOT_REFRESH_LOCK_STALE_MS>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"mcp-server-hubspot": {
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-hubspot"
],
"env": {
"HUBSPOT_CONFIG_DIR": "<your HUBSPOT_CONFIG_DIR>",
"HUBSPOT_ACCOUNT_EMAIL": "<your HUBSPOT_ACCOUNT_EMAIL>",
"MCP_WORKSPACE_PATH": "<your MCP_WORKSPACE_PATH>",
"HUBSPOT_CLIENT_ID": "<your HUBSPOT_CLIENT_ID>",
"HUBSPOT_CLIENT_SECRET": "<your HUBSPOT_CLIENT_SECRET>",
"HUBSPOT_SOURCE_LABEL": "<your HUBSPOT_SOURCE_LABEL>",
"HUBSPOT_DISABLE_REFRESH": "<your HUBSPOT_DISABLE_REFRESH>",
"HUBSPOT_ALLOW_CLOUD_REFRESH": "<your HUBSPOT_ALLOW_CLOUD_REFRESH>",
"HUBSPOT_REQUEST_TIMEOUT_MS": "<your HUBSPOT_REQUEST_TIMEOUT_MS>",
"HUBSPOT_REFRESH_LOCK_STALE_MS": "<your HUBSPOT_REFRESH_LOCK_STALE_MS>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"mcp-server-hubspot": {
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-hubspot"
],
"env": {
"HUBSPOT_CONFIG_DIR": "<your HUBSPOT_CONFIG_DIR>",
"HUBSPOT_ACCOUNT_EMAIL": "<your HUBSPOT_ACCOUNT_EMAIL>",
"MCP_WORKSPACE_PATH": "<your MCP_WORKSPACE_PATH>",
"HUBSPOT_CLIENT_ID": "<your HUBSPOT_CLIENT_ID>",
"HUBSPOT_CLIENT_SECRET": "<your HUBSPOT_CLIENT_SECRET>",
"HUBSPOT_SOURCE_LABEL": "<your HUBSPOT_SOURCE_LABEL>",
"HUBSPOT_DISABLE_REFRESH": "<your HUBSPOT_DISABLE_REFRESH>",
"HUBSPOT_ALLOW_CLOUD_REFRESH": "<your HUBSPOT_ALLOW_CLOUD_REFRESH>",
"HUBSPOT_REQUEST_TIMEOUT_MS": "<your HUBSPOT_REQUEST_TIMEOUT_MS>",
"HUBSPOT_REFRESH_LOCK_STALE_MS": "<your HUBSPOT_REFRESH_LOCK_STALE_MS>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"servers": {
"mcp-server-hubspot": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-hubspot"
],
"env": {
"HUBSPOT_CONFIG_DIR": "<your HUBSPOT_CONFIG_DIR>",
"HUBSPOT_ACCOUNT_EMAIL": "<your HUBSPOT_ACCOUNT_EMAIL>",
"MCP_WORKSPACE_PATH": "<your MCP_WORKSPACE_PATH>",
"HUBSPOT_CLIENT_ID": "<your HUBSPOT_CLIENT_ID>",
"HUBSPOT_CLIENT_SECRET": "<your HUBSPOT_CLIENT_SECRET>",
"HUBSPOT_SOURCE_LABEL": "<your HUBSPOT_SOURCE_LABEL>",
"HUBSPOT_DISABLE_REFRESH": "<your HUBSPOT_DISABLE_REFRESH>",
"HUBSPOT_ALLOW_CLOUD_REFRESH": "<your HUBSPOT_ALLOW_CLOUD_REFRESH>",
"HUBSPOT_REQUEST_TIMEOUT_MS": "<your HUBSPOT_REQUEST_TIMEOUT_MS>",
"HUBSPOT_REFRESH_LOCK_STALE_MS": "<your HUBSPOT_REFRESH_LOCK_STALE_MS>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"mcp-server-hubspot": {
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-hubspot"
],
"env": {
"HUBSPOT_CONFIG_DIR": "<your HUBSPOT_CONFIG_DIR>",
"HUBSPOT_ACCOUNT_EMAIL": "<your HUBSPOT_ACCOUNT_EMAIL>",
"MCP_WORKSPACE_PATH": "<your MCP_WORKSPACE_PATH>",
"HUBSPOT_CLIENT_ID": "<your HUBSPOT_CLIENT_ID>",
"HUBSPOT_CLIENT_SECRET": "<your HUBSPOT_CLIENT_SECRET>",
"HUBSPOT_SOURCE_LABEL": "<your HUBSPOT_SOURCE_LABEL>",
"HUBSPOT_DISABLE_REFRESH": "<your HUBSPOT_DISABLE_REFRESH>",
"HUBSPOT_ALLOW_CLOUD_REFRESH": "<your HUBSPOT_ALLOW_CLOUD_REFRESH>",
"HUBSPOT_REQUEST_TIMEOUT_MS": "<your HUBSPOT_REQUEST_TIMEOUT_MS>",
"HUBSPOT_REFRESH_LOCK_STALE_MS": "<your HUBSPOT_REFRESH_LOCK_STALE_MS>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"mcp-server-hubspot": {
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-hubspot"
],
"env": {
"HUBSPOT_CONFIG_DIR": "<your HUBSPOT_CONFIG_DIR>",
"HUBSPOT_ACCOUNT_EMAIL": "<your HUBSPOT_ACCOUNT_EMAIL>",
"MCP_WORKSPACE_PATH": "<your MCP_WORKSPACE_PATH>",
"HUBSPOT_CLIENT_ID": "<your HUBSPOT_CLIENT_ID>",
"HUBSPOT_CLIENT_SECRET": "<your HUBSPOT_CLIENT_SECRET>",
"HUBSPOT_SOURCE_LABEL": "<your HUBSPOT_SOURCE_LABEL>",
"HUBSPOT_DISABLE_REFRESH": "<your HUBSPOT_DISABLE_REFRESH>",
"HUBSPOT_ALLOW_CLOUD_REFRESH": "<your HUBSPOT_ALLOW_CLOUD_REFRESH>",
"HUBSPOT_REQUEST_TIMEOUT_MS": "<your HUBSPOT_REQUEST_TIMEOUT_MS>",
"HUBSPOT_REFRESH_LOCK_STALE_MS": "<your HUBSPOT_REFRESH_LOCK_STALE_MS>"
}
}
}
}Replace each placeholder with your own value before saving.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.mindstone%2Fmcp-server-hubspot)<a href="https://mcptoplist.com/server/io.github.mindstone%2Fmcp-server-hubspot"><img src="https://mcptoplist.com/badge/io.github.mindstone%2Fmcp-server-hubspot.svg" alt="MCP Toplist: Top 10% of 115,591" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Listed on 1 registry
mindstone
Available versions (5)
| Version | Published |
|---|---|
| 0.4.1 | Aug 8, 2026 |
| 0.4.0 | Aug 5, 2026 |
| 0.3.1 | Jul 30, 2026 |
| 0.3.0 | Jun 29, 2026 |
| 0.2.0 | May 21, 2026 |
Frequently asked questions
- Who maintains HubSpot?
- HubSpot is maintained by mindstone, which publishes 43 MCP servers (124 total versions) tracked on MCP Toplist.
- Is HubSpot listed on the Official MCP Registry?
- Yes — HubSpot is listed on the Official MCP Registry.
- How many versions does HubSpot have?
- MCP Toplist tracks 5 versions of HubSpot, most recently published on Aug 8, 2026.
- Where can I find the source code for HubSpot?
- The source code for HubSpot is hosted at github.com/mindstone/mcp-servers.