1. Home
  2. HubSpot integration
  3. HubSpot MCP

HubSpot's official MCP server works your CRM with the signed-in user's rights

Yes. HubSpot runs its own remote MCP server at mcp.hubspot.com, and MCP (the Model Context Protocol) is an open standard that lets an AI tool use another system. Through it, an agent can search, read, create and update CRM records, always inside the signed-in user's HubSpot permissions.

Checked 18 November 2026

HubSpot runs one official remote MCP server

The server is HubSpot’s own. Its docs give the address as https://mcp.hubspot.com. HubSpot says its AI connectors for Claude, Microsoft Copilot, Gemini and ChatGPT all run on this server. Its connector for Claude is an official MCP connector built by HubSpot, and HubSpot says it is free on every tier.

HubSpot pitches the server itself at builders. In its words, it is for people who need to add HubSpot data access to an agent they are creating. The setup page we read was last modified on November 12, 2026.

The server has no beta label of its own, and no HubSpot page we read calls it generally available either. Two parts carry a label. Reading revenue objects is marked BETA, and so is creating quotes, which needs Revenue Hub Professional or Enterprise. We found no dated launch post for the server in the HubSpot pages we read.

The server writes most CRM records; quotes are in beta

The server reaches most of the CRM. This table copies HubSpot’s own read and write lists:

Scroll the table sideways to see every column.

Area Read Create and edit
CRM records Contacts, companies, deals, tickets, leads, users, appointments, courses, listings, projects, services, custom objects and segments Contacts, companies, deals, tickets, leads, line items, products, appointments, courses, listings, projects, services and custom object records
Activities Calls, emails, meetings, notes and tasks Calls, emails, meetings, notes and tasks
Revenue objects Carts, invoices, orders, line items, products, quotes and subscriptions, in BETA Quotes, in BETA, on Revenue Hub Professional or Enterprise
Setup Custom properties for CRM objects

HubSpot widened the server in its Fall 2026 Spotlight, announced Sep 15, 2026. Custom objects, activable objects and the Leads object became readable and writable. HubSpot says every write through the new setup tools is attributed in the Audit Log.

Four tools do the CRM work, and none deletes a record

HubSpot’s public tool list names 36 tools, in the copy of its doc we saved on 18 November 2026. The tools you see depend on your subscription, your user’s permissions and how your account is set up. These four do the CRM record work:

  • search_crm_objects finds records with filters. It takes up to five filter groups of up to six filters each, and returns up to 200 results a page.
  • get_crm_objects fetches records by ID, with at most 100 IDs in one request.
  • manage_crm_objects creates or updates records. It first shows a summary of the proposed changes, then waits for the user to confirm.
  • query_crm_data runs SQL with HubSpot’s own extensions. It does not support joins, column aliases, subqueries, association traversal or currency conversion.

Some tools work only in three AI clients: Claude, ChatGPT and Gemini. Search runs on HubSpot’s CRM search API, which currently has no vector search. So an agent finds records by fields and filters. In the public list we read, the record tools create and update, and none deletes a CRM record.

The server signs in with OAuth and PKCE

You connect in three steps:

  1. In HubSpot, go to Development, then MCP Connectors, and create a connector.
  2. Point your MCP client at https://mcp.hubspot.com with the connector’s client ID and secret.
  3. Sign in with OAuth. HubSpot requires PKCE, an extra check that proves the sign-in came from your client. A client that doesn’t handle it must make a random code_verifier of 43 to 128 characters.

You don’t pick the connector’s scopes. HubSpot sets them from the server’s tools at install time and from the permissions the user grants. When HubSpot adds tools, users have to re-install the connector to grant the new scopes. Every action respects the user’s existing HubSpot permissions.

Two controls help an IT team. HubSpot supports client secret rotation for legacy public apps, project-based apps and MCP auth apps. And Claude Enterprise admins can limit the connector to company-provisioned accounts through verified domain restrictions.

Sensitive data stays mostly out of reach

Turn on HubSpot’s Sensitive Data setting and the MCP server can’t reach conversation data. HubSpot’s October 2026 rollup added a beta for AI connector access to Sensitive Data. Under it, ChatGPT, Claude and Copilot can read Sensitive Data properties and engagements. The remote MCP server can read engagements only. Access is read-only. A user still needs the object or property permissions to see anything, so the beta widens what a connector may read without widening what a person may see.

The developer MCP server builds apps, not CRM records

HubSpot has a second MCP server for a different job. The Developer MCP server helps you build HubSpot apps and CMS content in your code editor. You install it through the HubSpot CLI. HubSpot’s setup page asks for version 8.2.0 or higher, to get the latest set of supported AI clients. HubSpot’s docs say the remote server is separate from it. Use the developer server to write code for HubSpot, and the remote server to work with an account’s CRM data.

Your own MCP server can feed HubSpot’s agents

MCP also runs the other way. An app can add an MCP server component, and your external MCP server then shows up as agent tools in HubSpot’s Agent Builder. HubSpot’s guide marks this a public beta.

  • Platform version. HubSpot’s pages disagree here. The component guide, read on 18 November 2026, says 2027.03-beta or newer. HubSpot’s Fall 2026 Spotlight of Sep 15, 2026 said to set platformVersion to 2026.09. Follow the guide, and check it again before you build.
  • Sign-in. HubSpot’s sign-in flow does not support Dynamic Client Registration, so you issue a client ID yourself.
  • Review. A marketplace app with an MCP server component must pass HubSpot’s Ecosystem review before installed customers can use it. Until then, feature flags let you test with up to five installed accounts.

This is one way for an agent inside HubSpot to reach data that lives outside HubSpot.

A custom agent decides what the server should do

The server opens the door, but it makes no choices. Something still has to decide what to read, what to write and when to ask a person. MCP is an open-source standard for connecting AI apps to outside systems. Its spec says there should always be a human in the loop who can deny a tool call. A protected MCP server acts as an OAuth 2.1 resource server, so each call carries a token the server checks.

A custom agent can run on a schedule with no chat window at all. It can read a won deal through HubSpot’s server, pull facts from a system HubSpot doesn’t sync, and draft the next record for a person to approve.

HubSpot agents our team has built run on Anthropic’s Claude.

We did not review community-built HubSpot MCP servers for this page. Only the servers named above come from HubSpot. For the jobs an agent can take on, see HubSpot AI agents. For how the protocol works, read what an MCP server is.

Questions

Does HubSpot have an MCP server?

Yes. HubSpot runs an official remote MCP server at https://mcp.hubspot.com. It lets an AI agent search, read, create and update HubSpot records as the signed-in user. HubSpot's own connectors for Claude, Microsoft Copilot, Gemini and ChatGPT run on it. A second, separate server, the Developer MCP server, helps developers build HubSpot apps on their own machine.

Is the HubSpot MCP server free?

HubSpot says its connector for Claude is free on every tier. The developer pages we read for the server itself name no price. What you can do through it still depends on your plan. Creating quotes, for example, needs a Revenue Hub Professional or Enterprise subscription, and that feature is still in beta.

Can the HubSpot MCP server create quotes?

Yes, in beta. HubSpot's docs mark quote creation as BETA. It needs the manage revenue objects optional scope and a Revenue Hub Professional or Enterprise subscription. Reading carts, invoices, orders, line items, products, quotes and subscriptions is in beta too. Keep a person in the loop before any quote goes to a buyer.

How is the HubSpot MCP server different from the developer MCP server?

They do different jobs. The remote server works with an account's CRM data, much like HubSpot's APIs. The Developer MCP server runs on your own machine and helps you build HubSpot apps and CMS content in a code editor. HubSpot's setup page asks for HubSpot CLI version 8.2.0 or higher, to get the latest set of supported AI clients. HubSpot's docs say the two servers are separate.

Can an AI agent change HubSpot records without asking?

HubSpot's main write tool asks first. Its docs say manage_crm_objects shows a summary of the proposed changes and needs the user's explicit confirmation before any create or update. Every action also respects the user's HubSpot permissions. A custom agent can keep the same rule, so it drafts each change and a person approves it.

Can the HubSpot MCP server read sensitive data?

Only part of it, and only if an admin allows it. With Sensitive Data turned on, conversation data is blocked from the MCP server. HubSpot's October 2026 rollup added a beta for AI connector access. Under it, the remote MCP server can read engagements only, not Sensitive Data properties. Access is read-only, and users still need the right object or property permissions.

Sources

Every source behind a figure or a vendor fact on this page, with the day we read it.

Plan an agent on HubSpot's MCP server

Bring the AI tool you use, your HubSpot hubs and plans, and the job you want an agent to take on. The first call is free.

Plan my HubSpot agent