What HubSpot exposes
I get HubSpot data through a public REST API (key + OAuth 2.0 auth), a community-built MCP server (not official, watch for breakage), and 2,000-plus integrations including Zapier and Make. The API covers contacts, companies, deals, tickets, products, line items, marketing emails, forms, workflows, custom objects (Enterprise only), and CRM analytics; an OpenAPI spec is published at developers.hubspot.com. Webhooks are available across the platform for event-driven automation. Free and Starter tiers have rate-limited API access; Professional and Enterprise unlock higher quotas, custom objects, and the Operations Hub data sync features. HubSpot has no official llms.txt, /pricing.md, or /llm-info pages, which is unusual for a platform pitching AI agents. The community MCP server fills the gap for agent workflows, but plan for the lack of vendor-curated machine-readable docs.
Access, auth, and limits
Connect by pointing your MCP client at the remote server URL https://mcp.hubspot.com and completing the OAuth 2.1 (PKCE) consent flow, which links the agent to a specific HubSpot portal with scoped permissions. Because it's remote and OAuth-based, there's no API key to manage and no local server process to babysit.
Access follows your HubSpot user permissions, so an agent can only touch what your account can touch. The research doesn't specify a minimum plan tier for MCP access, so confirm on HubSpot's MCP docs whether it's gated to certain Hubs or seats before you promise a client anything.
Where it works and what to build
A practical workflow: ask your agent to 'find all deals in the pipeline that closed this month, pull the associated company records, and draft a follow-up task for each owner.' With CRM read/write over MCP, the agent does the lookups and updates directly against your portal instead of you exporting a CSV and manually reconciling.
Another useful one for a marketer: 'summarize the last 20 support tickets tagged onboarding and create a contact list of the accounts affected.' The research doesn't list which MCP clients are officially supported, so test your specific client (Claude Desktop, Claude Code, Cursor) against the server before you wire it into anything that matters.
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": ["mcp-remote", "<YOUR_MCP_URL>"]
}
}
}
// HTTP-transport MCP. Get your <YOUR_MCP_URL> from the vendor dashboard.
// Server source: https://mcp.hubspot.com
// Claude Code (one-liner): claude mcp add hubspot <YOUR_MCP_URL> --transport httpSome MCP servers require an API key. Check the source page for setup: mcp.hubspot.com.
Does HubSpot MCP cost extra?
HubSpot ships an official MCP server that uses your existing subscription credentials.
- No separate MCP licence to buy. You pay for your HubSpot plan, the MCP server queries that account.
- Whether it's gated to a specific tier wasn't extracted automatically — verify the access requirements on the MCP page or pricing docs.
HubSpot subscription pricing
| Plan | Monthly | Annual / mo |
|---|---|---|
| Free | Free | Free |
| Starter | $20 | $7 |
| Professional | $890 | $800 |
| Enterprise | — | $3,600 |
| HubSpot AEO | $50 | $45 |
Source: hubspot.com/pricing/marketing. Verified 2026-06-07.
HubSpot also publishes a REST API
HubSpot publishes an API, but per-tier gating wasn't extracted automatically.
See HubSpot API pageWhat 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.
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
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
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
Limits and gotchas
- Official MCP server — published by HubSpot themselves, so it should track product changes.
- 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.
Agent-readiness verdict
Wiring HubSpot into an agent through its official MCP server is worth it if HubSpot is your system of record and you want Claude or Cursor querying and updating the CRM without a custom integration. The OAuth 2.1 PKCE auth and official hosting are exactly what you want for something touching live customer data. The one thing holding it back from a 9 is that the exact tool list and client support aren't nailed down in public research yet, so build with a verification step. A strong 8 out of 10.
Strong agent fit with an official, HubSpot-hosted MCP server. The remote CRM MCP server at mcp.hubspot.com is generally available, connects any MCP client over streamable HTTP, and authenticates with OAuth 2.1 (PKCE), with read and write access across contacts, companies, deals, tickets, and more. An official npm package and a large documented API round it out. Agents get a first-party, well-supported integration path here.
Scored 2026-06-07 by Joonas (TMB).
HubSpot MCP & API FAQ
Is the HubSpot MCP server official?+
Can I use the HubSpot MCP with Cursor or Codex?+
Does HubSpot have a public API?+
Which LLMs does HubSpot integrate with directly?+
Sources
- HubSpot official site: https://www.hubspot.com
- MCP server page: https://mcp.hubspot.com
- API docs: https://developers.hubspot.com
- Pricing source: https://www.hubspot.com/pricing/marketing (verified 2026-06-07)
Data verified by Joonas on the dates shown. MCP server status auto-rechecked weekly.
10+ years in digital marketing. I review marketing software for AI-stack fit: real pricing, MCP and API support, and how cleanly each tool drops into an AI agent workflow, cross-checked against verified data and real user feedback.

