HubSpot
CommunityMCP server by ohneben · updated · ★ 1
HubSpot API: 1,000+ endpoints as safety-categorized, hub- and plan-aware MCP tools, stdio or HTTP. HubSpot is a community project by ohneben, not verified by a company domain.
Install HubSpot
Built from the published package, never by AIclaude mcp add hubspot -e MCP_TRANSPORT=YOUR_MCP_TRANSPORT -e HUBSPOT_ACCESS_TOKEN=YOUR_HUBSPOT_ACCESS_TOKEN -- docker run -i --rm -e MCP_TRANSPORT -e HUBSPOT_ACCESS_TOKEN ghcr.io/ohneben/hubspot-mcp:2.0.1Run in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"hubspot": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_TRANSPORT",
"-e",
"HUBSPOT_ACCESS_TOKEN",
"ghcr.io/ohneben/hubspot-mcp:2.0.1"
],
"env": {
"MCP_TRANSPORT": "YOUR_MCP_TRANSPORT",
"HUBSPOT_ACCESS_TOKEN": "YOUR_HUBSPOT_ACCESS_TOKEN"
}
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"hubspot": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_TRANSPORT",
"-e",
"HUBSPOT_ACCESS_TOKEN",
"ghcr.io/ohneben/hubspot-mcp:2.0.1"
],
"env": {
"MCP_TRANSPORT": "YOUR_MCP_TRANSPORT",
"HUBSPOT_ACCESS_TOKEN": "YOUR_HUBSPOT_ACCESS_TOKEN"
}
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"hubspot": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_TRANSPORT",
"-e",
"HUBSPOT_ACCESS_TOKEN",
"ghcr.io/ohneben/hubspot-mcp:2.0.1"
],
"env": {
"MCP_TRANSPORT": "YOUR_MCP_TRANSPORT",
"HUBSPOT_ACCESS_TOKEN": "YOUR_HUBSPOT_ACCESS_TOKEN"
}
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add hubspot --env MCP_TRANSPORT=YOUR_MCP_TRANSPORT --env HUBSPOT_ACCESS_TOKEN=YOUR_HUBSPOT_ACCESS_TOKEN -- docker run -i --rm -e MCP_TRANSPORT -e HUBSPOT_ACCESS_TOKEN ghcr.io/ohneben/hubspot-mcp:2.0.1{
"mcpServers": {
"hubspot": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_TRANSPORT",
"-e",
"HUBSPOT_ACCESS_TOKEN",
"ghcr.io/ohneben/hubspot-mcp:2.0.1"
],
"env": {
"MCP_TRANSPORT": "YOUR_MCP_TRANSPORT",
"HUBSPOT_ACCESS_TOKEN": "YOUR_HUBSPOT_ACCESS_TOKEN"
}
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
gemini mcp add hubspot docker run -i --rm -e MCP_TRANSPORT -e HUBSPOT_ACCESS_TOKEN ghcr.io/ohneben/hubspot-mcp:2.0.1Gemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
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.
Last commit 5 days ago
MIT: permissive, fine for commercial use
Clear description, published package or server URL, original repository
Not checked yet. What we check
What you need
| Setting | Needed | What it is |
|---|---|---|
MCP_Environment variable | Required | Server transport. Set to 'stdio' for local MCP clients; the image otherwise starts the Streamable HTTP transport. Default: stdio |
HUBSPOT_Environment variable, secret | Required | HubSpot service key or legacy private app token (pat-...), from Settings -> Integrations. An OAuth access token also works. |
HUBSPOT_Environment variable | Optional | API host. Default https://api.hubapi.com; use https://api-eu1.hubapi.com for EU data residency portals. |
HUBSPOT_Environment variable | Optional | 'discovery' (default) exposes 3 meta-tools that search, inspect and call all 1,076 endpoints; 'all' exposes the ~690 endpoint tools directly. Default: discovery |
HUBSPOT_Environment variable | Optional | Set to 'true' to expose only read-only tools. Default: false |
HUBSPOT_Environment variable | Optional | Read the token's scopes and probe paid-tier or beta API groups at startup (read-only, up to about 30 API calls). Set to 'false' to skip. Default: true |
MCP_Environment variable, secret | Optional | Only for MCP_TRANSPORT=http: bearer token required on /mcp. Without it a non-loopback bind refuses to start. |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
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 →Open-source MCP server for LinkedIn. Give Claude and any MCP-compatible AI agent access to profiles, companies, jobs, and messages.
Social intelligence for 10 networks: read posts and trends, monitor brand mentions, then create.
Official Model Context Protocol server for Plunk — send email, manage contacts, campaigns and segments from an AI agent
MCP server for searching and fetching 6,500+ brand SVGs from thesvg.org
Turn long videos into viral vertical shorts and publish them to TikTok, Instagram and YouTube.
Managed TikTok/Instagram/YouTube accounts + video posting at scale, operated by human managers.
HubSpot: common questions
How do I install HubSpot?
In Claude Code run claude mcp add hubspot -e MCP_TRANSPORT=YOUR_MCP_TRANSPORT -e HUBSPOT_ACCESS_TOKEN=YOUR_HUBSPOT_ACCESS_TOKEN -- docker run -i --rm -e MCP_TRANSPORT -e HUBSPOT_ACCESS_TOKEN ghcr.io/ohneben/hubspot-mcp:2.0.1. 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 ohneben, not verified by a company domain.
Is HubSpot free?
The code is published under the MIT licence. The service it connects to may have its own pricing.
Is HubSpot safe to use?
It scores 39 of 100. Grades: maintenance A, licence A, 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: Linkedin MCP server, Nooticr, Plunk MCP, Thesvg MCP Server.
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.
