{"id":1309,"date":"2026-10-05T16:55:53","date_gmt":"2026-10-05T13:55:53","guid":{"rendered":"https:\/\/fluidcrm.io\/blog\/?p=1309"},"modified":"2026-10-06T20:35:17","modified_gmt":"2026-10-06T17:35:17","slug":"hubspot-mcp","status":"publish","type":"post","link":"https:\/\/fluidcrm.io\/blog\/hubspot-mcp\/","title":{"rendered":"HubSpot MCP Server: 4 Limits to Know Before You Connect"},"content":{"rendered":"\n

Search for the HubSpot MCP server and you land on two different servers, a developer page about client secrets and a help article for Claude. Only one of those is meant for you if all you want is an assistant that can update a deal.<\/p>\n\n\n\n

HubSpot has two MCP servers, and the one most people want is the remote HubSpot MCP server behind the ready-made connectors for Claude and ChatGPT. It comes with every HubSpot plan. It has no delete, it changes ten records at a time and it shows no activity history when Sensitive Data is on.<\/strong><\/p>\n\n\n\n

<\/span>HubSpot’s Two MCP Servers And Which One You Need<\/span><\/h2>\n\n\n\n

HubSpot built two servers on the Model Context Protocol<\/a>, the standard that lets an AI assistant work inside other software. It gave them similar names for two very different jobs. If MCP is new to you, start with what an MCP server is<\/a>.<\/p>\n\n\n\n

The remote HubSpot MCP server lives at mcp.hubspot.com and works with the data in your account. The Developer MCP server is installed on a developer’s own computer and helps them build HubSpot apps and website assets. HubSpot’s docs say plainly that the two are separate.<\/p>\n\n\n\n

There is a third thing with “MCP” in its name, and it causes most of the confusion. Under Development in HubSpot you can create an MCP connector with a client ID and a secret. That is only for hooking up a tool HubSpot has no ready-made connector for.<\/p>\n\n\n\n

What you want<\/th>What to use<\/th>Who sets it up<\/th><\/tr><\/thead>
Claude or ChatGPT working with your contacts, deals and campaigns<\/td>The ready-made HubSpot connector inside Claude or ChatGPT<\/td>An admin approves it once, then each person connects<\/td><\/tr>
Another MCP client working with the same data<\/td>An MCP connector you create under Development in HubSpot<\/td>Someone comfortable with OAuth settings<\/td><\/tr>
An AI coding tool that helps you build a HubSpot app<\/td>The Developer MCP server<\/td>A developer, from the command line<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

If you are a marketer, a salesperson or a founder, you want the first row. The ready-made connector already sits on the remote server, so there is nothing to build.<\/p>\n\n\n\n

\"HubSpot's<\/figure>\n\n\n\n

<\/span>Four Limits Of The HubSpot MCP Server In Claude<\/span><\/h2>\n\n\n\n

HubSpot’s help article for the Claude connector is long and candid. These four limits come from it, and each one changes what you can hand over to an assistant.<\/p>\n\n\n\n

<\/span>1. It cannot delete or clear anything<\/span><\/h3>\n\n\n\n

The connector can view, create and update. HubSpot’s own example of what it won’t do is removing a contact’s phone number, so even emptying one field is off the table.<\/p>\n\n\n\n

So no record can be deleted because of a badly worded request. A wrong update still overwrites the old value, which is why the approval step later in this post matters. Connectors differ on where they draw this line, and the best CRMs for Claude<\/a> compares seven of them. For assistants other than Claude, the best MCP CRMs for AI agents<\/a> covers eight.<\/p>\n\n\n\n

<\/span>2. It writes ten records at a time<\/span><\/h3>\n\n\n\n

HubSpot states that bulk creates and updates are limited to ten records at once. Looking things up is far roomier, because a single search can return up to 200 records.<\/p>\n\n\n\n

Think of a library where you can read a whole shelf at once but only sign out ten books per visit. Ask Claude which 200 contacts have no owner and you get the answer in one go. Ask it to assign all 200 and that is at least twenty batches of ten.<\/p>\n\n\n\n

HubSpot doesn’t describe what the assistant does when you ask for more than ten, so plan around ten per step. Changes in the hundreds belong in a HubSpot import.<\/p>\n\n\n\n

How often does your team really change more than ten records in one sitting?<\/p>\n\n\n\n

<\/span>3. The Sensitive Data setting hides all activity<\/span><\/h3>\n\n\n\n

If your account has Sensitive Data turned on, the connector loses access to every call, email, meeting, note and task. Records stay visible, and the history behind them does not.<\/p>\n\n\n\n

Conversation history is what makes the answers good. A summary of a deal with no emails or call notes behind it is only a list of field values.<\/p>\n\n\n\n

<\/span>4. It drafts workflows and campaigns, and you build them<\/span><\/h3>\n\n\n\n

Ask Claude to set up an email campaign or a workflow and HubSpot says you get drafted content to put in place yourself. Nothing is built inside HubSpot for you.<\/p>\n\n\n\n

Marketing emails follow the same pattern. The connector can create and update email drafts and read how past sends performed, and sending is not on HubSpot’s list.<\/p>\n\n\n\n

<\/span>What The HubSpot MCP Server Can Do For Sales, Marketing And Support<\/span><\/h2>\n\n\n\n

HubSpot’s connector for Claude and ChatGPT reaches well past contacts and deals. If marketing and sales share one HubSpot account, both teams get real use out of it.<\/p>\n\n\n\n

Team<\/th>Can read<\/th>Can create or change<\/th>Not possible<\/th><\/tr><\/thead>
Sales<\/td>Contacts, companies, deals, leads, products, quotes and all logged activity<\/td>Contacts, companies, deals, leads, tasks, notes, calls, meetings and pipelines<\/td>Deleting, clearing a field, changing invoices, orders or subscriptions<\/td><\/tr>
Marketing<\/td>Campaigns, revenue attribution, marketing email results, page and blog analytics<\/td>Campaigns, marketing email drafts, landing pages, website pages and blog posts, including publishing<\/td>Sending an email, building a workflow<\/td><\/tr>
Support<\/td>Tickets, plus conversations from the inbox and help desk<\/td>Tickets, notes and tasks<\/td>Replying inside a conversation<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

A salesperson might ask “Summarise every conversation with Meridian this month and list anything that could block the deal.”<\/em> Marketing and support get the same kind of answer from “Which subject lines got the most clicks in September?”<\/em> or “What were the five most common help desk questions this week?”<\/em><\/p>\n\n\n\n

Custom objects are included, with read, create and update. HubSpot also applies your conditional property rules and pipeline stage checks to anything the connector writes. Association label checks are not applied.<\/p>\n\n\n\n

Publishing a blog post has its own requirement. HubSpot needs an author, a featured image, a meta description, a slug and a title before it will go live.<\/p>\n\n\n\n

\"HubSpot<\/figure>\n\n\n\n

HubSpot’s two pages don’t fully agree with each other. The help article lists segments as read-only, and the developer docs say static segments can be created and filled. Claude’s directory shows 36 tools where the developer docs list 32, so check what your own account offers once you are connected.<\/p>\n\n\n\n

<\/span>What The HubSpot MCP Server Does On Free And Paid Plans<\/span><\/h2>\n\n\n\n

HubSpot lists the connector under all products and plans, so a free account can use it. What changes with your plan is how much there is for the assistant to work with.<\/p>\n\n\n\n