HubSpot MCP Server: What It Does, What It Can't, and How to Connect It
What HubSpot's official MCP servers can read and write, how to connect them to Claude, ChatGPT or Cursor, and the limits to know first.

You want your AI tool to answer questions about your pipeline without exporting a CSV first. The HubSpot MCP server does that: "which deals in my book haven't moved in two weeks?", typed into Claude or Cursor and answered from live CRM data.
Below: what it reads and writes, how to connect it in each client, and where it stops.
What is the HubSpot MCP server?
The HubSpot MCP server is HubSpot's official bridge between AI assistants and your HubSpot account, built on the Model Context Protocol. HubSpot actually runs two distinct MCP servers (HubSpot Developers):
- The remote HubSpot MCP server at
mcp.hubspot.comgives any MCP-compatible AI tool or agent access to your HubSpot CRM data. It left public beta and became generally available to all HubSpot accounts on 13 April 2026 (HubSpot changelog). - The developer MCP server runs locally through the HubSpot CLI and helps you build apps and CMS content on HubSpot's developer platform. It reached general availability on 19 February 2026 (HubSpot changelog).
If you work in sales, marketing or support, you want the remote server. The developer server is a dev tool for people building HubSpot apps.
HubSpot's own Claude and ChatGPT connectors run on the same remote server: HubSpot calls it "the HubSpot MCP server that already powers your favorite AI connectors" (HubSpot). MCP itself is the open standard Anthropic introduced in November 2024 (Anthropic); HubSpot's server is one implementation of it, pointed at your CRM.
What can the HubSpot MCP server read and write?
It reads most of your HubSpot account and writes to CRM records, activities and marketing drafts. HubSpot's docs list 32 available tools, including search_crm_objects, manage_crm_objects and query_crm_data (HubSpot docs).
Read access:
- CRM records: contacts, companies, deals, tickets, leads, users, custom objects and segments. Revenue objects (quotes, invoices, orders, line items, products, carts, subscriptions) are in beta.
- Activities: calls, emails, meetings, notes and tasks.
- Content and marketing: blog posts, landing pages, site pages, campaigns, marketing events, content analytics and marketing email analytics.
- Conversations: threads from live chat, team email, WhatsApp, SMS and other connected inbox channels.
Write access:
- CRM records and activities: create and edit contacts, companies, deals, tickets, leads, custom objects and more; log calls, notes, tasks, meetings and emails.
- Content and campaigns: create, edit and publish landing pages, website pages and blog posts; create and update campaigns and marketing email drafts.
- Structure: pipelines, custom properties and static segments.
In practice, that covers three jobs. Querying: "show me every deal over $50k closing this quarter," without building a report. Drafting from CRM data: a follow-up email that references the last logged call, or a call-prep brief from a deal's engagement history. Updating: move a deal stage or log a note by describing it. Before any create or update, manage_crm_objects shows a proposed-changes summary and waits for your confirmation.
How do you connect the HubSpot MCP server?
The easiest route is HubSpot's own connector in Claude or ChatGPT; for Claude Code, Cursor and other clients you create an MCP connector in HubSpot and use its OAuth credentials. Either way, a HubSpot Super Admin may need to approve it first.
Claude (claude.ai and Claude Desktop)
HubSpot's connector for Claude needs a paid Claude plan (Pro, Max, Team or Enterprise) and works on every HubSpot plan (HubSpot Knowledge Base):
- In Claude, open Settings > Connectors and click Browse.
- Search for HubSpot, select it and click Connect.
- Log in to your HubSpot account, choose the permissions to allow and click Connect app.
- In a chat, open + > Connectors and turn HubSpot on. HubSpot recommends setting write tools to "Needs approval."
ChatGPT
- Open Settings > Apps, select HubSpot and click Connect (HubSpot Knowledge Base).
- Click Continue to HubSpot, sign in and choose your HubSpot account.
- Select the permissions to allow and click Connect app.
In both apps, Super Admins and users with App Marketplace Access can connect straight away; everyone else needs a Super Admin to approve the connector and set its data permissions.
Claude Code
- In HubSpot, go to Development > MCP Connectors and click Create MCP connector. Add
http://localhost:8080/callbackas the redirect URL. - Copy the connector's client ID and client secret.
- Add the server with pre-configured OAuth credentials, as Claude Code's MCP docs describe. The command prompts for the secret:
claude mcp add --transport http --client-id YOUR_CLIENT_ID --client-secret --callback-port 8080 hubspot https://mcp.hubspot.com
- Run
/mcpin a session to sign in, then ask Claude to runget_user_detailsto check which objects and tools your account can reach.
Cursor
Create an MCP connector as above with Cursor's desktop redirect URL, http://localhost:8787/callback. Then add the client ID and secret in the auth field of ~/.cursor/mcp.json (Cursor docs):
{
"mcpServers": {
"hubspot": {
"url": "https://mcp.hubspot.com",
"auth": { "CLIENT_ID": "<span class="blog-math-inline"><span class="katex"><span class="katex-mathml"><math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mrow><mi>e</mi><mi>n</mi><mi>v</mi><mo>:</mo><mi>H</mi><mi>U</mi><mi>B</mi><mi>S</mi><mi>P</mi><mi>O</mi><msub><mi>T</mi><mi>C</mi></msub><mi>L</mi><mi>I</mi><mi>E</mi><mi>N</mi><msub><mi>T</mi><mi>I</mi></msub><mi>D</mi></mrow><mi mathvariant="normal">"</mi><mo separator="true">,</mo><mi mathvariant="normal">"</mi><mi>C</mi><mi>L</mi><mi>I</mi><mi>E</mi><mi>N</mi><msub><mi>T</mi><mi>S</mi></msub><mi>E</mi><mi>C</mi><mi>R</mi><mi>E</mi><mi>T</mi><mi mathvariant="normal">"</mi><mo>:</mo><mi mathvariant="normal">"</mi></mrow><annotation encoding="application/x-tex">{env:HUBSPOT_CLIENT_ID}", "CLIENT_SECRET": "</annotation></semantics></math></span><span class="katex-html" aria-hidden="true"><span class="base"><span class="strut" style="height:0.8889em;vertical-align:-0.1944em;"></span><span class="mord"><span class="mord mathnormal">e</span><span class="mord mathnormal">n</span><span class="mord mathnormal" style="margin-right:0.0359em;">v</span><span class="mspace" style="margin-right:0.2778em;"></span><span class="mrel">:</span><span class="mspace" style="margin-right:0.2778em;"></span><span class="mord mathnormal" style="margin-right:0.0813em;">H</span><span class="mord mathnormal" style="margin-right:0.109em;">U</span><span class="mord mathnormal" style="margin-right:0.0502em;">B</span><span class="mord mathnormal" style="margin-right:0.0576em;">S</span><span class="mord mathnormal" style="margin-right:0.1389em;">P</span><span class="mord mathnormal" style="margin-right:0.0278em;">O</span><span class="mord"><span class="mord mathnormal" style="margin-right:0.1389em;">T</span><span class="msupsub"><span class="vlist-t vlist-t2"><span class="vlist-r"><span class="vlist" style="height:0.3283em;"><span style="top:-2.55em;margin-left:-0.1389em;margin-right:0.05em;"><span class="pstrut" style="height:2.7em;"></span><span class="sizing reset-size6 size3 mtight"><span class="mord mathnormal mtight" style="margin-right:0.0715em;">C</span></span></span></span><span class="vlist-s"></span></span><span class="vlist-r"><span class="vlist" style="height:0.15em;"><span></span></span></span></span></span></span><span class="mord mathnormal">L</span><span class="mord mathnormal" style="margin-right:0.0785em;">I</span><span class="mord mathnormal" style="margin-right:0.0576em;">E</span><span class="mord mathnormal" style="margin-right:0.109em;">N</span><span class="mord"><span class="mord mathnormal" style="margin-right:0.1389em;">T</span><span class="msupsub"><span class="vlist-t vlist-t2"><span class="vlist-r"><span class="vlist" style="height:0.3283em;"><span style="top:-2.55em;margin-left:-0.1389em;margin-right:0.05em;"><span class="pstrut" style="height:2.7em;"></span><span class="sizing reset-size6 size3 mtight"><span class="mord mathnormal mtight" style="margin-right:0.0785em;">I</span></span></span></span><span class="vlist-s"></span></span><span class="vlist-r"><span class="vlist" style="height:0.15em;"><span></span></span></span></span></span></span><span class="mord mathnormal" style="margin-right:0.0278em;">D</span></span><span class="mord">"</span><span class="mpunct">,</span><span class="mspace" style="margin-right:0.1667em;"></span><span class="mord">"</span><span class="mord mathnormal" style="margin-right:0.0715em;">C</span><span class="mord mathnormal">L</span><span class="mord mathnormal" style="margin-right:0.0785em;">I</span><span class="mord mathnormal" style="margin-right:0.0576em;">E</span><span class="mord mathnormal" style="margin-right:0.109em;">N</span><span class="mord"><span class="mord mathnormal" style="margin-right:0.1389em;">T</span><span class="msupsub"><span class="vlist-t vlist-t2"><span class="vlist-r"><span class="vlist" style="height:0.3283em;"><span style="top:-2.55em;margin-left:-0.1389em;margin-right:0.05em;"><span class="pstrut" style="height:2.7em;"></span><span class="sizing reset-size6 size3 mtight"><span class="mord mathnormal mtight" style="margin-right:0.0576em;">S</span></span></span></span><span class="vlist-s"></span></span><span class="vlist-r"><span class="vlist" style="height:0.15em;"><span></span></span></span></span></span></span><span class="mord mathnormal" style="margin-right:0.0576em;">E</span><span class="mord mathnormal" style="margin-right:0.0715em;">C</span><span class="mord mathnormal" style="margin-right:0.0077em;">R</span><span class="mord mathnormal" style="margin-right:0.0576em;">E</span><span class="mord mathnormal" style="margin-right:0.1389em;">T</span><span class="mord">"</span><span class="mspace" style="margin-right:0.2778em;"></span><span class="mrel">:</span><span class="mspace" style="margin-right:0.2778em;"></span></span><span class="base"><span class="strut" style="height:0.6944em;"></span><span class="mord">"</span></span></span></span></span>{env:HUBSPOT_CLIENT_SECRET}" }
}
}
}
Any other client works if it handles OAuth with PKCE, which HubSpot requires. The MCP Inspector is the quickest way to test a new connector.
The developer MCP server
Install HubSpot CLI 8.2.0 or later, run hs mcp setup, and pick your clients: Claude Code, Codex CLI, Cursor, Gemini CLI, VS Code or Windsurf (HubSpot docs).
What are the HubSpot MCP server's limits?
It's a doorway, not a worker. The server hands your CRM to an AI inside a conversation you start: nothing watches HubSpot for you, nothing fires when a deal changes stage, and nothing runs while the chat is closed. For that, you still need HubSpot workflows.
The other limits to plan around:
- Sensitive Data blocks activities. If your account has Sensitive Data turned on, calls, emails, meetings, notes, tasks and conversation data are blocked from the MCP server, though not from the standard CRM API.
- No deletes, small batches. HubSpot's Claude and ChatGPT connector guides say no object can be deleted, bulk creates and updates are capped at 10 records, and only one HubSpot account can be connected at a time.
- Search, not semantic search. The server is built on the CRM search API, with no vector search, so
search_crm_objectsfilters records and returns up to 200 results per page;query_crm_datatakes SQL but no joins. - No published MCP rate limit. HubSpot says connector usage is subject to its API usage limits and doesn't publish a separate cap for MCP.
- New scopes mean reinstalling. Scopes are set by the tools available when you install, so each user reconnects when HubSpot adds objects.
- Large responses cost tokens. HubSpot's docs warn that
get_propertiesresponses can be large; every record you pull lands in the model's context window. More in the MCP context tax.
Is the HubSpot MCP server safe?
It's as safe as the HubSpot user who connects it, since every action follows that user's existing permissions. The specific risk is prompt injection: your CRM holds inbound emails, chat transcripts and form fills written by people outside your company, and the AI reads them as text. In the MCPTox benchmark, poisoned tool descriptions on 45 real MCP servers got o1-mini to follow them 72.8% of the time (Wang et al., 2025).
Keep write tools on "Needs approval," grant only the permissions the job needs, and review connector activity in HubSpot's audit log. The full threat model is in Is MCP Safe?
Where does Unabyss fit next to the HubSpot MCP server?
HubSpot MCP knows your CRM records; Unabyss gives your AI tools the context around them. Unabyss imports your HubSpot deals with their linked contacts and companies, alongside Gmail, Google Calendar, Slack, Notion and the other apps on its integrations page. It keeps that context current and serves it to Claude, ChatGPT and Cursor over one MCP connection, so the AI knows how a deal got to its stage, not just the stage field.
Unabyss doesn't act inside HubSpot: it doesn't update records, log activities or send emails. Many people run both, HubSpot MCP for live CRM actions and Unabyss for standing context. In an August 2026 Unabyss benchmark, adding that context to the same connected tools cut cost by 36% and follow-up prompts by 60% (What Structured AI Context Is Worth). For setting up sales context specifically, see How Salespeople Should Set Up Context for Their AI Tools, and for other vendor servers, Best MCP Servers for Work. See how Unabyss works.