Skip to content
Book a build

What is the HubSpot MCP server, and how do you set it up?

The HubSpot MCP server is HubSpot's remote Model Context Protocol server at mcp.hubspot.com. It lets AI clients such as Claude Code, Cursor or your own agent read HubSpot CRM, marketing and content data and make some changes, acting with the connecting user's permissions. You create an MCP connector in your HubSpot account to get OAuth credentials, and your client signs in with PKCE.

On this page

What HubSpot supports natively

HubSpot runs two different MCP servers. People searching “HubSpot MCP server” usually mean the first.

Remote HubSpot MCP serverDeveloper MCP server
Where it runsHosted at https://mcp.hubspot.comLocally, through the HubSpot CLI
ForAI clients and agents working with portal dataAgentic coding tools building HubSpot apps
Set up withAn MCP connector created in your HubSpot account (OAuth with PKCE)hs mcp setup
Acts onCRM records, activities, marketing and content assetsCLI tasks, scaffolding, developer docs, deploys of app projects

What the remote server can do

HubSpot’s reference documents 32 public tools as of October 2026. In summary:

  • Read: CRM records (including custom object records and segments), activities, marketing emails, campaigns, pages and blog analytics, conversations, owners, users and account details, AEO data. A SQL-style query_crm_data tool handles counts and trends.
  • Write: create and edit CRM records and activities, create custom properties, create and manage pipelines, create segments and add or remove records from static segments, draft marketing emails, edit landing pages, website pages and blog posts, and manage campaigns.
  • Not covered: workflows, forms, editing existing properties and creating custom object definitions.

HubSpot’s Fall 2026 developer changelog announced more than the reference documents: creating and managing custom properties, and scheduling and publishing marketing emails. The tool reference still describes creating properties and working on email drafts, so test those actions before you rely on them.

Some tools have conditions: AEO tools need Marketing Hub Professional or Enterprise, quotes need Revenue Hub Professional or Enterprise, and the website page, blog post and preview tools are only available for select clients. For the property, pipeline and workflow detail, see what the HubSpot MCP can create.

How to set up the HubSpot MCP server

  1. In HubSpot, go to Development → MCP Connectors and click Create MCP connector.
  2. Enter a name and one or more redirect URLs (the first is the default), then create it.
  3. Copy the client ID and client secret from the details page.
  4. In your MCP client, set the server URL to https://mcp.hubspot.com with the Streamable HTTP transport and those credentials. PKCE is required.
  5. Sign in, choose the HubSpot account and grant permissions. Everything the client does respects that user’s HubSpot permissions.

If HubSpot adds tools later, users reinstall to grant the new scopes.

Documented limits

  • Search returns up to 200 results per page, with up to five filter groups of six filters each.
  • Fetching by ID takes up to 100 IDs per request; owner search returns up to 100 results.
  • query_crm_data doesn’t support joins, aliases, subqueries, association traversal or currency conversion.
  • Search is keyword-based; HubSpot notes there’s no vector search.

Where Jetstack AI fits

Jetstack AI runs a separate MCP server at https://mcp.jetstack.ai, signed in with a Jetstack access token whose scopes limit what the assistant can do. Its tools cover what HubSpot’s server doesn’t: browsing a portal’s workflows, forms, lists and properties, importing them with dependencies, deploying them to another portal with a reviewed mapping, and running audits. The tool list is in the MCP server docs; see the developer overview for the API and CLI.

To build new setup, including the workflows and forms neither server creates, we recommend Projects: you describe the build in a brief, approve a plan, approve deployment separately and get a receipt read back from HubSpot. It’s currently in limited release; see how it compares with Claude and the HubSpot MCP.

Sources

Checked October 29, 2026. HubSpot changes its products often; tell us at team@jetstack.ai if something here is out of date.

AI, Claude & MCP

Do it from your own code or AI agent.

The Jetstack AI REST API, MCP server and CLI share API keys and scopes. Create and manage those keys in the app.

Read the developer docs

AI, Claude & MCP

Related questions.

What is the HubSpot MCP server, and how do you set it up?

The HubSpot MCP server is HubSpot's remote Model Context Protocol server at mcp.hubspot.com. It lets AI clients such as Claude Code, Cursor or your own agent read HubSpot CRM, marketing and content data and make some changes, acting with the connecting user's permissions. You create an MCP connector in your HubSpot account to get OAuth credentials, and your client signs in with PKCE.

Is there a HubSpot MCP server on GitHub?

HubSpot's documentation describes the hosted remote server at mcp.hubspot.com and a local developer server installed through the HubSpot CLI with hs mcp setup. You don't need to run anything from GitHub to use either.

Do I need a developer account to use the HubSpot MCP server?

You create the MCP connector under Development in your HubSpot account. Each account can hold a combined 100 project-based apps, service keys and MCP connectors.

Does the HubSpot MCP server work with Sensitive Data?

Partly. If Sensitive Data is turned on, activity and conversation data is blocked through the MCP server. That restriction applies only to the MCP server, not to the standard CRM APIs.