HubSpot MCP Server for Claude, ChatGPT and Cursor

“HubSpot MCP” can mean six different things in 2026. HubSpot runs a remote MCP server at https://mcp.hubspot.com for developers who build agents, ships ready-made connectors for Claude and ChatGPT built on that server, and offers a local Developer MCP server for building HubSpot apps and CMS themes. Hosted servers such as the Ryze AI one sit on top of HubSpot’s regular REST API, and developers self-host community servers from GitHub. This page documents the Ryze AI server and compares it with HubSpot’s options in section 06.

All five need workspace when your client connection covers more than one Ryze AI workspace, and all five take an optional connection_id to target one portal when a workspace holds several. objectType is contacts, companies, deals or the fullyQualifiedName of a custom object.

A search request, as the agent sends it

{
  "filterGroups": [
    { "filters": [
      { "propertyName": "createdate", "operator": "GTE", "value": "1790812800000" },
      { "propertyName": "lastname", "operator": "NOT_HAS_PROPERTY" }
    ] }
  ],
  "properties": ["email", "firstname", "createdate"],
  "limit": 200
}

Contacts created since Oct 1, 2026 (the value is in milliseconds) that have no last name. Both filters sit in one group, so a contact has to match both. Before it filters on a property, the agent can confirm the internal name with read on crm/v3/properties/contacts, and get_provider_docs returns HubSpot’s own API notes when it needs a request shape. list_connections shows which portals are connected. Ad and analytics tools on the same URL are documented on Google Ads MCP, Meta Ads MCP and Google Analytics MCP.

The join between an ad platform and HubSpot runs through traffic source properties that HubSpot sets automatically from each contact’s interactions. Original Traffic Source is the first known source; its two drill-downs carry the detail, and for paid traffic that detail is the utm_campaign value on your ad URL. Companies and deals tied to a contact copy the same values, and nobody can edit the drill-downs by hand.

Values from HubSpot’s traffic source article, updated Aug 4, 2026. An ad URL without utm_campaign leaves no campaign name to match, so ask the agent to list unmatched contacts next to the matched ones.

Every answer comes from your own portal and ad accounts, so no sample numbers are shown here. A walk-through of the Google Ads, Meta Ads and deal-amount-by-source prompts, with what comes back, is in how to connect Claude to HubSpot.

Step 1: link your HubSpot portal in Ryze AI

1. 01On the Integrations page in Ryze AI, find the HubSpot card and click Connect. Ryze AI hands you over to HubSpot.
2. 02Sign in to HubSpot. If your login sees more than one portal, select it and click Choose Account.
3. 03Read the permission list HubSpot shows and approve it. The card turns Connected, and View lists the portal by its HubSpot domain.
4. 04Publishing articles to HubSpot? Under View, pick the Blog and the Author and click Save. CRM-only users leave both empty.

Screens for each step are in the Ryze AI HubSpot guide.

Claude on the web or desktop

1. 01Go to Customize, Connectors (Settings, Connectors links there).
2. 02Choose + Add, then Add custom connector. Enter Ryze AI as the name and https://connector.get-ryze.ai/mcp as the MCP server URL. No client ID or secret is needed.
3. 03Press Connect, tick the workspace that holds HubSpot and press Allow connection.
4. 04Start a fresh chat; connectors only load in chats opened after the connection.

Any Claude plan works, and Free holds one custom connector. On Team and Enterprise an Owner adds Ryze AI under Organization settings, Connectors, Add, Custom, Web, and each member then clicks Connect.

ChatGPT

On Plus, Pro or Business, open Settings, Apps, Advanced settings and switch on Developer mode. Choose Create app, name it Ryze AI, paste the URL, set authentication to OAuth, then use Sign in with Ryze AI and allow the workspace. ChatGPT stores the tool list when the app is created; after connecting HubSpot later, remove the app and add it again.

Claude Code

claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp --scope user

Type /mcp, choose ryze and finish sign-in in the browser. --scope user loads it in every project; --scope project writes a shared .mcp.json instead. Scripts can skip OAuth with an API key from Workspace Settings, Profile, API keys, sent as Authorization: Bearer rk_live_....

Cursor, Windsurf and VS Code

{ "mcpServers": {
  "ryze": { "url": "https://connector.get-ryze.ai/mcp" }
} }

{ "servers": {
  "ryze": { "type": "http", "url": "https://connector.get-ryze.ai/mcp" }
} }

Windsurf reads the Cursor entry with serverUrl in place of url. Each client opens a sign-in window the first time a tool runs. Claude Desktop can also start the server from claude_desktop_config.json through npx -y mcp-remote https://connector.get-ryze.ai/mcp, which needs Node; the full entry is on the developer page.

Grok Bot, Make, n8n and Zapier

In Grok Bot, Ryze AI is a built-in connector: Connect Apps, search Ryze AI, Add, sign in. Make, n8n and Zapier have no one-click app, so point their MCP or HTTP MCP node at the URL and authorize.

Scope names and plan columns from HubSpot’s scopes reference; actions from the Ryze AI help center, checked Nov 7, 2026. Ryze AI does not publish its exact scope list, so treat the HubSpot consent screen as the source of truth. On a Free or Starter portal the blog rows do not apply, because HubSpot only grants content on Professional and Enterprise.

Removing access

In HubSpot, uninstall the app under Settings, Integrations, Connected Apps. In Ryze AI, open View on the HubSpot card and use the trash icon for one portal. In Claude, open Customize, Connectors, Ryze AI and click Disconnect, which cuts off every workspace at once.

Six things called HubSpot MCP

HubSpot says its connectors for Claude, ChatGPT, Microsoft Copilot and Gemini run on the remote MCP server, and that the server itself is meant for teams building their own agents. With Sensitive Data turned on, HubSpot blocks activities and conversations through that server. Sources: developers.hubspot.com, knowledge.hubspot.com (both connector articles updated Nov 6, 2026) and HubSpot’s GA notice for the remote server, checked Nov 7, 2026.

The four hosted options side by side

As published on Nov 7, 2026. HubSpot adds tools to its server often, so check its tool list before you decide.

Which to pick: if the work stays inside HubSpot, HubSpot’s connector for Claude or ChatGPT covers more HubSpot objects (tickets, activities, campaigns, landing pages) and needs no extra account. If you are building your own agent, HubSpot’s remote server is the direct route. Ryze AI fits when the question crosses tools, such as cost per contact by Google Ads campaign or Meta campaigns that became deals, when one agency login has to reach several portals, or when you need an archive tool.

From HubSpot’s API usage guidelines and CRM Search API reference, checked Nov 7, 2026. Which burst limit applies depends on how an app is distributed, and Ryze AI does not publish that for its HubSpot app. The Search API limit applies either way.

The first eight rows are Ryze AI connections. The rest come from HubSpot’s own server and connectors, as reported on the HubSpot Community, the n8n forum and GitHub between January and October 2026, plus HubSpot’s rate limit docs. More Ryze AI answers are in the integrations FAQ.