---
title: "What is the HubSpot MCP server? Setup and limits"
description: "What the HubSpot MCP server is: the remote server at mcp.hubspot.com versus the local developer server, its tools, setup steps and documented limits."
url: "https://jetstack.ai/answers/hubspot-mcp-server/"
---

# 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.

![](https://jetstack.ai/images/authors/aditya-kumar.webp)

By [Aditya Kumar](https://jetstack.ai/authors/aditya-kumar/) Founder, Jetstack AI

Updated October 29, 2026

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 server                                          | Developer MCP server                                            |
| ------------- | ------------------------------------------------------------------ | --------------------------------------------------------------- |
| Where it runs | Hosted at `https://mcp.hubspot.com`                                | Locally, through the HubSpot CLI                                |
| For           | AI clients and agents working with portal data                     | Agentic coding tools building HubSpot apps                      |
| Set up with   | An MCP connector created in your HubSpot account (OAuth with PKCE) | `hs mcp setup`                                                  |
| Acts on       | CRM records, activities, marketing and content assets              | CLI 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](https://developers.hubspot.com/changelog/fall-2026-spotlight) 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](https://jetstack.ai/answers/hubspot-mcp-create-properties-pipelines-workflows).

## 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](https://jetstack.ai/docs/developers/mcp); see the [developer overview](https://jetstack.ai/docs/developers) for the API and CLI.

To build new setup, including the workflows and forms neither server creates, we recommend [Projects](https://jetstack.ai/build): 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](https://jetstack.ai/compare/hubspot-mcp-claude).

## Sources

- [Integrate with the remote HubSpot MCP server (HubSpot Developers)](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server)
- [HubSpot MCP (HubSpot Developers)](https://developers.hubspot.com/mcp)
- [Account service keys (HubSpot Developers)](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/account-service-keys)
- [MCP server (Jetstack AI documentation)](https://jetstack.ai/docs/developers/mcp)

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

![Aditya Kumar](https://jetstack.ai/images/authors/aditya-kumar.webp)

About the author

[Aditya Kumar](https://jetstack.ai/authors/aditya-kumar/)

Founder, Jetstack AI

Aditya Kumar is the founder of Jetstack AI, the AI platform HubSpot partners and RevOps teams use to audit portals, build implementations and reuse their best setups across portals. He writes about HubSpot architecture, automation and AI from the work of building it.

[More from Aditya](https://jetstack.ai/authors/aditya-kumar/) [LinkedIn](https://www.linkedin.com/in/aditya-ambrstack/)

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](https://jetstack.ai/docs/developers)

On this page

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.
