HubSpot MCP server: setup, pricing & agent-readiness

How to connect HubSpot MCP to Claude Desktop

Add this block to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Cursor and Codex use a similar schema.

{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": ["-y", "<server-package-name>"],
      "env": {
        "HUBSPOT_API_KEY": "your-api-key-here"
      }
    }
  }
}
// Server source: https://github.com/baryhuang/mcp-hubspot
// Check the server's README for the exact "command" and required env vars.

Some MCP servers require an API key. Check the source page for setup: github.com/baryhuang/mcp-hubspot.

Does HubSpot MCP cost extra?

Community (free)

The HubSpot MCP server is community-built — free to run, but you still pay for your HubSpot subscription.

Community MCPs are normally self-hosted from a GitHub repo. There's no extra license fee.
Your HubSpot account still needs whatever plan is required to access the data the MCP server queries.
Trade-off: zero MCP cost, but no guarantee it'll keep working when HubSpot changes their UI or API.

MCP cost

Free (self-hosted)

Subscription required

Yes (your tool plan)

Maintained by

Community

HubSpot subscription pricing

Plan	Monthly	Annual / mo
Free	Free	Free
Starter	$20	$15
Professional	$890	$890
Enterprise	$3,600	$3,600

Source: hubspot.com/pricing/marketing. Scraped 2026-05-19.

HubSpot also publishes a REST API

HubSpot publishes an API, but per-tier gating wasn't extracted automatically.

API docs

—

Auth method

—

SDK languages

—

OpenAPI spec

—

Webhooks

—

Structured outputs

—

See HubSpot API page

What you can do with HubSpot from an AI agent

Three shapes of agent workflow. Pick the row that matches how you actually use Claude / Cursor / Codex day to day.

INDIE / SOLO

Skip the dashboard, ask Claude

"What changed this week?" answered in seconds
Quick one-off questions without leaving the editor
Pipe HubSpot data into your personal notes / docs without writing a script

Effort: 30 seconds — paste the config, restart Claude

AGENCY

Run client analysis at agent speed

Hand the MCP server to your team — every consultant can ask Claude about any client's HubSpot account
Multi-account workflows without context-switching the HubSpot UI
Reports you'd normally spend hours on, done before standup

Effort: An afternoon — set up auth per client

IN-HOUSE TEAM

Production agent workflows

Embed in your internal Codex / Cursor agents that triage HubSpot data daily
Combine with other MCP servers in a multi-step agent chain
Constrain agents to read-only roles to keep production HubSpot safe

Effort: Days — security review + role config

Limits and gotchas

Community MCP — not maintained by HubSpot. Check the README and last-update date before depending on it.
Fallback: the REST API works for any flow the MCP server doesn't cover.
Rate limits: MCP calls count against your underlying HubSpot API quota. Burst usage from a curious agent can drain a daily allowance fast.

4/10

Agent-readiness verdict

Limited agent-readiness without official support. HubSpot has a community MCP server and works with Claude and ChatGPT, but lacks published API documentation, OpenAPI specs, and structured outputs that agents need for reliable automation. Official MCP support and documented API endpoints would unlock much stronger integration.

MCP server availableNative Claude integrationNative ChatGPT integration

Scored 2026-05-19 by Joonas (TMB).

HubSpot MCP & API FAQ

Is the HubSpot MCP server official?+

No — it's a community build, not maintained by HubSpot. Expect occasional drift and check the README before depending on it for production agents.

Can I use the HubSpot MCP with Cursor or Codex?+

Yes — MCP is a protocol, not Claude-specific. Any MCP-capable client (Cursor, Codex, Windsurf, Zed) can use the same server config with minor path adjustments.

Which LLMs does HubSpot integrate with directly?+

ChatGPT, Claude, Gemini, Perplexity, Copilot. Direct integrations skip the need for custom API wrappers.

Sources

HubSpot official site: https://www.hubspot.com
MCP server page: https://github.com/baryhuang/mcp-hubspot
Pricing source: https://www.hubspot.com/pricing/marketing (scraped 2026-05-19)

Data verified by Joonas on the dates shown. MCP server status auto-rechecked weekly.

HubSpot MCP Server

What is the HubSpot MCP server?

What you actually do with the HubSpot MCP