How to connect ChatGPT to HubSpot

Connect HubSpot once in Ryze AI, add one MCP URL to ChatGPT as a custom MCP server, then ask about contacts, companies and deals in plain English.

Your MCP URL
https://connector.get-ryze.ai/mcp

Copies the link and opens ChatGPT Plugins, where you add a custom MCP server. See the steps

See pricing

By Ira Bodnar, Ryze AI · Updated · Connector tested November 13, 2026

Quick answer

The main way to connect ChatGPT to HubSpot is the Ryze AI connector. Connect HubSpot in a Ryze AI workspace with HubSpot's own sign-in, then add https://connector.get-ryze.ai/mcp in ChatGPT on the web as a custom MCP server with OAuth, install the plugin it becomes and start a new conversation. Ryze AI is the best HubSpot connector for ChatGPT when you also want blog publishing and several portals in one connection, but HubSpot's own ChatGPT connector is simpler if you only need CRM records.

  1. In Ryze AI open Integrations, find HubSpot and click Connect
  2. Sign in to HubSpot, choose the account and approve the permissions
  3. In ChatGPT open Plugins, add a custom MCP server with the URL and OAuth
  4. Sign in to Ryze AI, allow the workspace, then type @ in a new chat

ChatGPT to HubSpot at a glance

FactDetail
Main way to connectThe Ryze AI connector: one hosted MCP address that you add on ChatGPT web, under Plugins, as a custom MCP server
Server addresshttps://connector.get-ryze.ai/mcp
Sign-inOAuth in the browser, twice: HubSpot's sign-in inside Ryze AI, then the Ryze AI sign-in from ChatGPT. ChatGPT's form has no API key option
HubSpot tools5: 3 read, 1 write, 1 delete
Can it change HubSpotYes, with hubspot__write and hubspot__delete, where the ChatGPT plan has full MCP. By default ChatGPT asks you to confirm each write action from a custom MCP server
ChatGPT plan neededBusiness or Enterprise/Edu for full MCP, on ChatGPT web. Pro connects with read and fetch permissions. OpenAI's article does not mention Free, Go or Plus
HubSpot user neededA Super Admin, or a user with App Marketplace Access
Ryze AI pricePaid Ads plan: $89 per month, 7-day free trial. No charge for adding the connector
HubSpot's own option for ChatGPTThe HubSpot connector for ChatGPT, under Settings, Apps. It reaches more object types, has no delete and creates or updates at most 10 records per bulk request
HubSpot access of the Ryze AI connectionContacts, companies and deals to read and write, owners and lists to read, and blog content. Tickets, custom objects and list editing are not included
Last testedThe connector on November 13, 2026, and 11 HubSpot calls on November 14, 2026. No step was run inside ChatGPT

Before you start

  • A ChatGPT plan that allows custom MCP servers. OpenAI's help article says custom MCP server connections and full MCP support are available to ChatGPT Business and Enterprise/Edu customers on ChatGPT web. Pro users can connect custom MCP servers with read and fetch permissions only, so write actions are not available there. The article does not mention Free, Go or Plus.
  • Admin rights on Business or Enterprise/Edu. On Business, only admins and owners can create and publish plugins for custom MCP servers. On Enterprise/Edu, admins and owners can, and admins can grant other members permission through role-based access control.
  • Super Admin or App Marketplace Access in HubSpot. HubSpot lets only these users install apps. Anyone else needs a Super Admin to connect HubSpot for them.
  • A Ryze AI workspace on a plan or free trial. Paid Ads is $89 per month with a 7-day free trial. Adding the connector is free, but the HubSpot tools need an active plan or trial.

How to connect ChatGPT to HubSpot in Plugins

Three steps happen in Ryze AI and HubSpot, four in ChatGPT. The connector URL is the same for every user.

  1. Connect HubSpot in Ryze AI

    Create a Ryze AI account or sign in, open Integrations, find the HubSpot card and click Connect. Ryze AI sends you to HubSpot to authorize.

  2. Choose the HubSpot account

    Sign in to HubSpot, choose the account (portal) you want ChatGPT to work with and click Choose Account.

    HubSpot screen titled Connecting your Ryze AI account to HubSpot, with the buttons Create a new HubSpot account and Sign in to your HubSpot account
  3. Approve the permissions

    Approve the permissions HubSpot lists. HubSpot returns you to Ryze AI with the connection saved. Optional, for blog publishing: click View on the HubSpot card, pick the Blog and the Author, and click Save.

    The HubSpot window in Ryze AI after connecting, showing an example account by its HubSpot domain with the primary star, blog and author choices, the Add one more account button and the trash icon
  4. Add a custom MCP server in ChatGPT Plugins

    On ChatGPT web go to Plugins (chatgpt.com/plugins), select the plus button, then Add custom MCP server. Enter the name Ryze AI, and under Connection enter https://connector.get-ryze.ai/mcp as the Server URL. OpenAI says Developer Mode does not need to be turned on first, though account and workspace policies still apply.

  5. Choose OAuth and create the plugin

    Under authentication choose OAuth. Review the risk warning and select I understand and want to continue, then select Create as a plugin and review the tools ChatGPT discovered.

  6. Sign in to Ryze AI and allow the workspace

    When ChatGPT asks, complete the Ryze AI sign-in, choose the workspace that holds your HubSpot connection and click Allow connection. OpenAI does not fix the moment for that screen: some plugins ask during install, others on first use. To install, open the plugin under your personal plugins, or in the workspace where you created it, and select the plus button.

  7. Start a new conversation and call Ryze AI

    Open a new conversation, type @ and select Ryze AI. Ask: Search HubSpot deals created in the last 30 days and show the name, amount and stage of each. The @ pick covers that one message, so type it again when a follow-up needs fresh HubSpot data.

The Ryze AI help article for HubSpot covers the HubSpot side of the connection, and the Ryze AI ChatGPT guide covers the ChatGPT side.

Sources for the ChatGPT steps: OpenAI: add custom MCP server, OpenAI plugins quickstart, OpenAI: connecting custom MCP servers in ChatGPT. Checked November 14, 2026.

The legacy custom app flow

OpenAI's help article still documents an older path that builds a custom app from the Apps settings page. Try Plugins first. If your workspace still shows only the Apps flow, follow these steps. The ChatGPT screens carry OpenAI's names, and the sign-in screens are the Ryze AI ones:

  1. Admins and owners open Workspace settings, then Apps, then Create. Members an admin has authorized start from their own settings, then Apps, then Create.
  2. Name the app Ryze AI and enter https://connector.get-ryze.ai/mcp as the endpoint, with any other details the form asks for.
  3. Pick OAuth as the authentication mechanism.
  4. Select Scan Tools. The sign-in comes during the scan for an OAuth server: log in to Ryze AI, choose the workspace and click Allow connection, then wait for the scan to finish.
  5. Select Create. The draft app shows under Settings, Apps, Enabled Apps, with the label Dev next to its name.
  6. Start a new chat.

The Ryze AI help center describes this path with a Developer mode switch under Advanced settings, a Create app button and the I understand and want to continue checkbox. None of the three appears in OpenAI's account of the older path as read on November 14, 2026. For the Plugins flow above, OpenAI says Developer Mode is not needed first, and the checkbox is part of that flow.

Sources: OpenAI: connecting custom MCP servers in ChatGPT, Ryze AI ChatGPT guide. Checked November 14, 2026.

Business and Enterprise/Edu workspaces

On Business and Enterprise/Edu, members cannot add Ryze AI themselves until an admin or owner publishes it. The admin does this:

  1. Connect and test Ryze AI as described above.
  2. Open Admin Console, select the workspace, then Plugins, Manage Legacy Apps, Drafts and Publish. Review the safety warnings for write actions.
  3. On Enterprise/Edu, use Configure Actions and Configure Access before publishing if you want to limit what members can do.
  4. Members then find the published app under Settings, Plugins.

OpenAI notes that after an admin approves a connection, ChatGPT uses a frozen snapshot of its tools. Changes apply only after an admin refreshes and publishes an update. On that refresh, new actions arrive switched off and changed ones are shown as a diff.

ChatGPT and custom MCP servers: the facts in one table

TopicWhat OpenAI's pages say
Where the server goesChatGPT on the web: Plugins (chatgpt.com/plugins), the plus button, Add custom MCP server. Web chats read no config file
TransportsSSE and streaming HTTP. The web form takes a Server URL or a Tunnel, never a local command
Sign-in choicesOAuth, No authentication, or OAuth or no authentication. OpenAI's authentication guide says ChatGPT cannot present custom API keys
How the OAuth sign-in runsChatGPT reads the server's protected resource metadata, then runs the authorization code flow with PKCE and S256. Without static client credentials it registers itself, through a Client ID Metadata Document or dynamic client registration
Tool approvalWrite actions need confirmation by default, and a tool without the readOnlyHint annotation counts as a write action
Permission settingsAlways ask, Allow read actions and Allow low-risk actions, under Settings, Plugins, Permissions. Allow all actions may be offered for a single app or connected account only. OpenAI's pages do not say which setting a plugin made from a custom MCP server starts on
PlanFull MCP on Business and Enterprise/Edu, read and fetch permissions on Pro. OpenAI's developer pages name no plan
Who may add a server in a workspaceBusiness: admins and owners only. Enterprise/Edu: also members who hold the permission Create plugins with MCPs, which is off by default for Enterprise
Where connections are managedSettings, Plugins, where each connected account has Reconnect and Disconnect. Admins use Admin console, the workspace, then Plugins
Desktop appSettings, MCP servers in the ChatGPT desktop app configures the Codex host. ChatGPT web chats do not read that configuration

Sources: OpenAI: add custom MCP server, OpenAI: connecting custom MCP servers in ChatGPT, OpenAI authentication guide, OpenAI: managing app permissions, OpenAI: plugins in ChatGPT, OpenAI: managing app accounts, OpenAI: admin controls for plugins, OpenAI MCP docs. Checked November 14, 2026.

ChatGPT limits to know

These limits come from OpenAI's help article and developer docs and apply to any custom MCP server, Ryze AI included.

LimitWhat it means
Web onlyCustom MCP servers cannot be connected on mobile. Set Ryze AI up on ChatGPT web.
Pro is read onlyPro accounts get read and fetch permissions, so creating or updating HubSpot records needs a Business or Enterprise/Edu workspace.
ConfirmationsWrite actions may ask for confirmation based on app permissions and context, and some risky actions may be blocked.
Deep researchDeep research can use custom apps for read and fetch actions only.
Company knowledgeCompany knowledge includes only apps that have search and fetch functions.
Tool list refreshFor a server connected directly, open it in Plugins and select Refresh to pull new metadata (OpenAI developer docs). The Ryze AI help center says to remove the app, install it again and start a new chat after you connect a new platform.

Sources: OpenAI: connecting custom MCP servers in ChatGPT, OpenAI developers: connect ChatGPT, Ryze AI ChatGPT guide. Checked November 14, 2026.

Other AI clients

HubSpot is connected once in Ryze AI, so the HubSpot side does not change for other clients.

Claude

In Claude, open Customize, Connectors and add the same URL as a custom connector. The steps are in the Claude guide for HubSpot.

HubSpot permissions and scopes

Three things decide what ChatGPT can see in HubSpot.

Who can connect
A HubSpot Super Admin or a user with App Marketplace Access. Anyone else needs a Super Admin to do the install.
Which account
One connection is one HubSpot portal. You can add more portals to the same Ryze AI workspace with Add one more account. The starred one is the primary and is used unless you name another in chat.
What ChatGPT can do
ChatGPT calls the Ryze AI tools, and those work through the HubSpot connection you approved. HubSpot's OAuth guide says an access token carries the scopes the app requested and does not reflect the permissions of the user who installed it. HubSpot's example: a user who can view only the contacts they own still hands the app a token that can view every contact in the account. So the scopes below set the reach. Connect a portal only if you are comfortable sharing that much of it.

Permissions Ryze AI requests

The Ryze AI connection asks HubSpot for these permissions. The HubSpot consent screen is the source of truth for the exact list.

AccessLevel
Contacts, companies and dealsRead and write
OwnersRead
Contact schemaRead
Deal schemaRead and write
ListsRead
Content (blog posts)Required
Files, CMS functions, knowledge base, membershipOptional

Source: Ryze AI HubSpot integration.

HubSpot's own names for that access

Each access level above has a matching entry in HubSpot's scope reference, listed here with HubSpot's description and the accounts it is offered to. Ryze AI documents its access in words, so the consent screen you approve holds the exact list. The Ryze AI listing in the HubSpot Marketplace names 8 shared data types: Contacts, Contact Properties, Companies, Deals, Deal Properties, Contact Lists, Owners and CMS Blog Post.

AccessMatching entry in HubSpot's scope listHubSpot's descriptionOffered to
Contacts, read and writecrm.objects.contacts.read, crm.objects.contacts.writeView contact properties and details. Create, delete and change contactsAll accounts
Companies, read and writecrm.objects.companies.read, crm.objects.companies.writeView company properties and details. Create, delete or change companiesAll accounts
Deals, read and writecrm.objects.deals.read, crm.objects.deals.writeView deal properties and details. Create, delete or change dealsAll accounts
Owners, readcrm.objects.owners.readView details about users assigned to a CRM recordAll accounts
Contact schema, readcrm.schemas.contacts.readView property settings for contactsAll accounts
Deal schema, read and writecrm.schemas.deals.read, crm.schemas.deals.writeView, create, delete or change property settings for dealsAll accounts
Lists, readcrm.lists.readView details about contact listsAll accounts
ContentcontentHubSpot's content APIs, which include website pages, landing pages and blogsCMS Hub or Marketing Hub, Professional or Enterprise
Files, optionalfilesA legacy scope for the HubSpot file managerAll accounts
CMS functions, optionalcms.functions.read, cms.functions.writeContent Hub serverless functions and secretsContent Hub Enterprise
Knowledge base, optionalcms.knowledge_base.articles.read and related scopesView details about knowledge articlesService Hub Professional or Enterprise
Membership, optionalcms.membership.access_groups.read, cms.membership.access_groups.writeView, create, edit and delete membership access groupsService Hub or Content Hub, Professional or Enterprise

HubSpot handles the two groups differently. A required scope has to be authorized for the install to succeed, and HubSpot shows an error when the chosen account has no access to one. An optional scope is dropped from the request when the account lacks that tool.

Not among the access Ryze AI documents: ticket scopes, custom object scopes, list editing (crm.lists.write), company property settings (crm.schemas.companies.read) and HubSpot's Sensitive Data scopes. On November 14, 2026 a ticket search sent through the Ryze AI connection came back as not_allowed. If ChatGPT has to work with tickets or custom objects, HubSpot's own connector for ChatGPT covers both.

Sources: HubSpot scopes reference, HubSpot OAuth guide, Ryze AI listing in the HubSpot Marketplace, HubSpot: install and uninstall apps. Checked November 14, 2026.

Removing access

To remove access, click View on the HubSpot card in Ryze AI and use the trash icon to disconnect a portal. You can also uninstall the app inside HubSpot: Settings, Integrations, Connected Apps, Actions on the app, Uninstall, then type uninstall to confirm. In ChatGPT, open Settings, Plugins, select the Ryze AI plugin and use Disconnect next to the connected account. You can also remove the plugin, but OpenAI's pages disagree on whether uninstalling alone ends the connection.

What ChatGPT can do in HubSpot

The Ryze AI connector exposes five HubSpot tools. Each runs as the HubSpot account you connected.

ToolTypeWhat it does
hubspot__listObjectsReadLists CRM records of one object type page by page, with the properties you choose and the IDs of associated records.
hubspot__searchReadSearches CRM records through the HubSpot CRM Search API with filter groups, sorts, a text query and chosen properties.
hubspot__readReadSends a GET request to any HubSpot JSON API resource, such as a record, property definitions, owners, a list or blog posts.
hubspot__writeWriteCreates or updates a HubSpot resource, such as a contact, company, deal or blog post, and adds associations between records.
hubspot__deleteDeleteDeletes (archives) a HubSpot resource by ID, such as a CRM record or blog post.

In the Ryze AI chat the Tool approvals setting starts on Skip all approvals; switch it to Approve write & delete or Manual approve if you want a check first. Scheduled tasks run without an approval step. In ChatGPT, OpenAI says write actions on a custom MCP server need confirmation by default, people and admins can change when ChatGPT asks under Plugins, Permissions, and on Pro write actions are not available at all.

HubSpot limits in numbers

LimitDetail
Records per search page10 by default and 200 at most. hubspot__search passes your limit on to HubSpot, which rejected 201 in the test
Results per search query10,000 in total. HubSpot answers a request for anything past that with a 400 error
Filters in one search5 filter groups with up to 6 filters each, and 18 filters in total
Filter operators in hubspot__search12: EQ, NEQ, GT, GTE, LT, LTE, BETWEEN, IN, NOT_IN, HAS_PROPERTY, NOT_HAS_PROPERTY and CONTAINS_TOKEN
Length of one search3,000 characters at most. A longer request body gets a 400 error
Search requests per second5 per HubSpot account
Search freshnessA new or changed record can take a few moments to show up in search. Archived records never show up
Fields a search returns unaskedContacts: firstname, lastname, email, lastmodifieddate, hs_object_id, createdate. Companies: name, domain, createdate, hs_lastmodifieddate, hs_object_id. Deals: dealname, amount, closedate, pipeline, dealstage, createdate, hs_lastmodifieddate, hs_object_id
Records per list page100 contacts in one request, which is also the highest limit hubspot__listObjects accepts
Requests per 10 seconds110 for each account that installs an OAuth app from the HubSpot Marketplace, search requests not counted, and a 429 error past a limit. HubSpot's page does not name Ryze AI, and no response in the test carried a rate limit header
Deleted CRM recordsRestorable from the recycling bin for up to 90 days
HubSpot's own ChatGPT connector10 records per bulk create or update request

Sources: HubSpot CRM search guide, HubSpot API usage guidelines, HubSpot contacts API guide, HubSpot: restore deleted records, HubSpot connector for ChatGPT. Checked November 14, 2026. The figures for hubspot__search and hubspot__listObjects come from the tool definitions and the test calls of the same day.

What the Ryze AI connection answered, call by call

Each row covers one or more calls that went through the Ryze AI connection to a HubSpot portal on November 14, 2026. Every filter was built to match nothing and every ID was made up, so nothing from the portal's records is shown. They were made from Claude Code through the connector address that ChatGPT would use too.

CallWhat was sentWhat came back
hubspot__search on contacts, companies and deals3 calls, each with a filter for an email, a domain or a deal name equal to 20 random lettersAll 3 worked and returned the empty result {"total":0,"results":[]}
hubspot__listObjects on contactsLimit 1 and the single property hs_object_idWorked. One result with the keys id, properties, createdAt, updatedAt, archived and url, plus a paging block with an after value. HubSpot added createdate and lastmodifieddate to the one property asked for
hubspot__search with an unknown propertyA contact filter on a property name that does not existRefused with Error 400
hubspot__search with limit 201A contact search that asked for 201 records per pageRefused with Error 400, category VALIDATION_ERROR
hubspot__search on ticketsA ticket filter that could not matchRefused with the status not_allowed
hubspot__read of a dealThe path crm/v3/objects/deals/0The status not_found
hubspot__read of a contactA contact path ending in an 18-digit ID that does not existThe status not_found. HubSpot sent an HTML 404 page
hubspot__read of a blog post, twiceThe path cms/v3/blogs/posts/ with 2 made-up post IDsThe status not_found with an HTML 404 page, both times. That does not show whether blog reads work on the portal

First 3 prompts to run

These prompts use only the HubSpot tools above. Each answer comes from your own portal, so this page describes what comes back instead of showing sample numbers.

1. Find stalled deals

Search HubSpot for open deals with no update in the last 30 days. Show the deal name, amount, stage and owner for each.

Tools used: hubspot__search on deals, hubspot__read for owners

What comes back: A list of matching deals with the properties you named, and the owner for each deal.

2. Review one company

List the contacts and deals associated with the company Northwind Traders, with each contact's job title and each deal's stage.

Tools used: hubspot__search on companies, hubspot__listObjects with associations

What comes back: The company, its associated contacts and deals, and the IDs of the records so you can follow up on any of them.

3. Add a note-worthy deal

Create a HubSpot deal named Q1 renewal for the company Northwind Traders and associate it with its main contact.

Tools used: hubspot__search, hubspot__write

What comes back: The created deal and its associations. This needs a plan with write access in ChatGPT, not Pro, and you can ask ChatGPT to confirm before it runs.

Replace the example company name with one from your portal. HubSpot returns a default subset of properties unless you ask for specific fields, so name the ones you need.

10 jobs to hand to ChatGPT

10 jobs to hand to ChatGPT once the plugin is installed, each with the HubSpot tool behind it. In the test the search tool ran with filters that match nothing and the list tool with a limit of 1. The write and delete tools were not run, and from ChatGPT they need a Business or Enterprise/Edu workspace.

JobAsk ChatGPTToolWorks on the default connection
Look up a contactFind the HubSpot contact with this email and show their job title and lifecycle stage.hubspot__searchYes
Deals from the last 30 daysList the deals created in the last 30 days with name, amount and stage.hubspot__searchYes
Stalled dealsFind open deals with no change in 30 days and name the owner of each.hubspot__search, then hubspot__read for ownersYes. The owners read was not part of the test
Company overviewFind the company with this domain and list its associated contacts and deals.hubspot__search, then hubspot__listObjects with associationsYes. Associations were not requested in the test
Contacts page by pageGo through my contacts 100 at a time and show lifecycle stage and create date for each.hubspot__listObjectsYes
Property checkShow which contact and deal properties exist before you build a filter.hubspot__readYes. Not part of the test
Create a dealCreate a deal for this company and associate it with its main contact.hubspot__writeYes, with full MCP in ChatGPT. Not run in the test
Update a recordMove this deal to the stage I name, then read the deal back to me.hubspot__write, then hubspot__readYes, with full MCP in ChatGPT
Remove a duplicateDelete the contact with this ID.hubspot__deleteYes, with full MCP in ChatGPT. Most CRM deletes land in the recycling bin, where they stay restorable for up to 90 days
Ticket searchList the open tickets for this company.hubspot__searchNo. A ticket search was refused in the test. HubSpot's own ChatGPT connector covers tickets

7 ways to connect ChatGPT to HubSpot

There are 7 ways to give ChatGPT access to a HubSpot account. This guide uses the first one, the Ryze AI connector, as the main way: one address for every user, delete kept apart from write, and several HubSpot portals in one workspace. The other 6 were opened on their own pages on November 14, 2026.

WayRuns whereSetup in ChatGPTWhat it reaches in HubSpotPrice
Ryze AI connector (the main way)Hosted, one address for every userOn ChatGPT web: Plugins, the plus button, Add custom MCP server, the address https://connector.get-ryze.ai/mcp and OAuth. HubSpot is connected once, with its own sign-in inside Ryze AIContacts, companies and deals, contact lists, owners and CMS blog content. Read, create, update and delete. No tickets or custom objects$89 per month on Paid Ads (7-day free trial), plus a ChatGPT plan that allows custom MCP servers
HubSpot connector for ChatGPTHosted by HubSpot, used inside ChatGPTProfile icon, Settings, Apps, HubSpot, Connect, then sign in to HubSpot. Super Admins and users with App Marketplace Access connect directly; others need a Super Admin to approve the connector firstContacts, leads, companies, deals, tickets, custom objects, campaigns, landing pages, blog posts, segments and engagement records, to read, create and update. No delete, 10 records per bulk request, one HubSpot account per ChatGPT account, and drafts as metadata only. A Super Admin can grant read-only access to Sensitive Data, in public betaHubSpot states no price: all HubSpot customers on every tier with an OpenAI account
HubSpot remote MCP serverHosted by HubSpot at https://mcp.hubspot.comHubSpot gives no ChatGPT steps. It says any client with OAuth and PKCE can connect. Create an MCP connector under Development, MCP Connectors (it asks for a redirect URL), then add the address in Plugins with OAuth and the connector's client ID and secret, which ChatGPT uses as static credentials. HubSpot's overview points ChatGPT users to the ready-made connector instead36 documented tools that read and write CRM records, activities, campaigns, pages and blog posts, within the permissions granted. No delete tool, 200 results per search page, and no vector search, joins or currency conversionHubSpot states no price. Open to all HubSpot accounts since April 13, 2026
ComposioHostedInstall the Composio plugin from the marketplace under Settings, Plugins, or add https://connect.composio.dev/mcp as a Streamable HTTP server on the MCP tab of the Plugins page and authenticate354 HubSpot tools and 2 triggers, to read and to write, by Composio's countPer its pricing page: free with 10,000 tool calls a month, or Standard at $18 per seat per month
Zapier MCPHostedPlugins, Add, Create custom MCP server, the name Zapier MCP, the connection https://mcp.zapier.com/api/v1/connect and OAuthThe HubSpot actions you enable in your Zapier account. Zapier prints no totalEach successful tool call uses 2 tasks of the Zapier plan: 100 tasks a month on Free, 750 on Professional from $19.99 per month billed annually
Windsor.aiHostedConnect HubSpot as a data source in Windsor.ai, then add Windsor MCP from the Plugins list in ChatGPTReporting data: 1,141 HubSpot fields, of which 287 are metrics and 854 dimensions. Its MCP page names no write action for HubSpotIncluded on every plan. The free plan covers 1 data source, and Basic is $23 per month on monthly billing
Coupler.ioHostedBuild a data flow in Coupler.io that loads HubSpot, then follow the MCP Server page inside Coupler.io. Its pricing table names ChatGPT among the AI integrationsRead-only analysis of the HubSpot datasets your flows load, as aggregated data without individual recordsFree at $0 and Starter at $32 per month. Its pages differ on which plan includes the MCP server

5 options that do not fit a ChatGPT chat

  • HubSpot Developer MCP server. A local server installed through the HubSpot CLI. None of its 23 tools reads CRM records, and its client list is Claude Code, Codex CLI, Cursor, Gemini CLI, VS Code and Windsurf, without ChatGPT.
  • @hubspot/mcp-server on npm. HubSpot's earlier beta server starts with npx on your own machine and takes a private app access token. Its README names Claude Desktop and Cursor, and ChatGPT web accepts a server address, never a local command.
  • HubSpot Agent CLI (beta). A command-line program that an AI agent runs to read and change CRM records, installed on your computer or in the agent's workspace. HubSpot's knowledge base article does name coding agents in the ChatGPT app, the Claude app and Claude Code. It offers no server address, and the Plugins form on ChatGPT web takes nothing else.
  • HubSpot's connectors for other assistants. A connector for Claude, a read-only connector for Gemini, the HubSpot Agent for Microsoft 365 Copilot and a plugin repository for Claude Code. None of those pages names ChatGPT.
  • baryhuang/mcp-hubspot, open source. 7 tools for contacts, companies and engagement data in a Docker container that you run yourself. The README gives the setup for the Claude desktop app. MIT license, 129 GitHub stars, last push November 11, 2025.

Which one to pick

Ryze AI is the best way to connect ChatGPT to HubSpot when you want delete as its own tool, publishing to a chosen blog and author, and several portals behind one address, with two caveats: tickets, custom objects and list editing are outside its access, and changes from ChatGPT need a Business or Enterprise/Edu workspace. If you only work with HubSpot records, HubSpot's own connector is simpler: it needs no Ryze AI account, works from Settings, Apps, reaches more object types and shows each user only what their HubSpot permissions allow. The remote MCP server suits a team that builds its own agent. Composio and Zapier make sense when your team already runs other apps through one of them. Windsor.ai and Coupler.io fit reporting on HubSpot data.

Sources: HubSpot connector for ChatGPT, HubSpot remote MCP server, HubSpot remote MCP server overview, HubSpot Developer MCP server, @hubspot/mcp-server on npm, HubSpot Agent CLI, HubSpot AI tools, HubSpot connector for Claude, HubSpot connector for Gemini, HubSpot Agent for Copilot, HubSpot plugins for Claude Code, Composio HubSpot for ChatGPT, Composio pricing, Zapier MCP for ChatGPT, Zapier MCP usage, Zapier pricing, Windsor MCP, Windsor.ai HubSpot fields, Windsor.ai pricing, Coupler.io HubSpot MCP, Coupler.io pricing, baryhuang/mcp-hubspot, Ryze AI HubSpot integration. Checked November 14, 2026.

ChatGPT, HubSpot and MCP: dates that matter

DateWhat happened
June 4, 2025HubSpot announced its deep research connector for ChatGPT, live the same day. OpenAI's release notes of that date list custom connectors through MCP, available only in deep research.
September 1, 2025The remote HubSpot MCP server went into its initial public beta.
October 17, 2025OpenAI began rolling out full MCP support, with read and write, in beta for Business, Enterprise and Edu.
April 13, 2026The remote HubSpot MCP server became generally available to all HubSpot accounts, with write access added and OAuth 2.1 with PKCE required.
July 9, 2026The Plugin Directory replaced the App Directory in ChatGPT. Existing app connections were not affected.
October 1, 2026Admins on Business and Enterprise plans began managing plugins in Admin console. Its Plugins page links to the older Apps page through Manage Legacy Apps.
October 30, 2026HubSpot put AI connector access to Sensitive Data into public beta. A Super Admin can let the ChatGPT connector read Sensitive Data properties and engagements.
November 12, 2026HubSpot last updated its knowledge base article for the ChatGPT connector.

Sources: HubSpot changelog, June 4, 2025, HubSpot changelog on the remote MCP server beta, HubSpot changelog, April 13, 2026, HubSpot changelog, October 2026, ChatGPT release notes, ChatGPT Business release notes, ChatGPT Enterprise and Edu release notes, HubSpot connector for ChatGPT. Checked November 14, 2026.

How this guide was tested

This guide rests on two test runs and on the vendors' own pages. The connector's address and sign-in details were checked on November 13, 2026. 11 read-only HubSpot calls went through the connector on November 14, 2026: 6 to hubspot__search, 4 to hubspot__read and 1 to hubspot__listObjects.

What was runWhat came back
The connector address, with no sign-in (November 13)Asked without a sign-in, https://connector.get-ryze.ai/mcp answered HTTP 401 and sent a WWW-Authenticate header that points at its sign-in details. OpenAI's authentication guide says that one header is enough for ChatGPT to find a server's sign-in metadata.
The sign-in details (November 13)The connector's host served both discovery files. They list an authorize, a token and a register endpoint, the grants authorization code and refresh token, PKCE with S256 and the scopes mcp:read and mcp:write. S256 is the challenge method OpenAI says ChatGPT requires.
The HubSpot tool list (November 14)All 5 tool definitions loaded by name from the connector. They match the tools table on this page.
4 calls that worked (November 14)hubspot__search on contacts, companies and deals returned valid empty results for filters that could not match. hubspot__listObjects on contacts with limit 1 returned one result and a paging cursor.
7 calls that were refused or found nothing (November 14)2 searches with a bad input, 1 ticket search and 4 reads of IDs that do not exist. Their messages are in the errors table below.

Not run for this page: every step inside ChatGPT. No server was added there, no sign-in was done there and no tool was called from a ChatGPT conversation, so the ChatGPT steps follow OpenAI's pages as they read on November 14, 2026. The HubSpot calls were sent from Claude Code, which reaches the same server and the same 5 tools. hubspot__write and hubspot__delete were not run, because they change the portal. No existing record was read by ID, and no owners, lists, property definitions or blog posts were listed. Also untested: whether ChatGPT stays signed in after the first access token expires. OpenAI asks servers to advertise offline_access. The connector's sign-in details list the refresh token grant, and their only scopes are mcp:read and mcp:write, without offline_access.

HubSpot errors and fixes

Exact error messages from the test

These are the exact messages HubSpot and the connector returned in the test on November 14, 2026. They were not seen in ChatGPT itself. OpenAI says you can expand each tool call there to read its full input and output, which is where a message like this would show.

MessageWhat it meansWhat to do
limit must be in range [0..200] (actual value: 201)Error 400 with the category VALIDATION_ERROR. A CRM search returns at most 200 records per page.Ask ChatGPT for 200 or fewer per page and to continue with the after value.
There was a problem with the request.Error 400. The search filtered on a property name that does not exist, and HubSpot does not say which property is wrong.Ask ChatGPT to read the property definitions first and to use the internal property name.
The scope needed for this API call isn't available for public use. If you have questions, contact support or post in our developer forum.The status not_allowed. The Ryze AI connection could not search tickets on the test portal.Keep to contacts, companies and deals through Ryze AI. For tickets, use HubSpot's own connector for ChatGPT.
Object not found. objectId is usually positive.The status not_found. The read asked for a deal with the ID 0, and no record has that ID.Search for the record first and use the id that the search returns.
provider returned text/html;charset=iso-8859-1 (status 404) "Error 404 Not Found"The status not_found. HubSpot answered reads of a made-up contact ID and of 2 made-up blog post IDs with an HTML 404 page, and the read tool reports the 404. The full message also names the path and carries a trace value, left out here.Check the ID. Search for the contact by email, or list the blog posts and take an ID from that list.

Other problems

ChatGPT has no Add custom MCP server option
Custom MCP servers need a Business or Enterprise/Edu workspace, or Pro with read and fetch only. On Business an admin or owner must create and publish it. Check with your workspace admin.
HubSpot shows an error during the install
Your HubSpot user is not a Super Admin or lacks App Marketplace Access. Ask a Super Admin to connect HubSpot in Ryze AI, or to grant you the permission.
The wrong HubSpot account is connected
Each connection is one portal. Click View on the HubSpot card in Ryze AI, connect the right portal with Add one more account, then remove the wrong one with the trash icon.
The HubSpot connection stopped working
The token may have been revoked or permissions changed. Click Reconnect on the HubSpot card and authorize again.
HubSpot tools do not appear in ChatGPT
ChatGPT keeps the tool list from when you added the server. Open the server in Plugins and select Refresh, or remove it, add it again and start a new chat.
A field is missing from the results
HubSpot returns a default set of properties unless specific fields are requested. Ask ChatGPT for the exact properties you need.
ChatGPT will not write to HubSpot
Pro accounts have read and fetch permissions only, and ChatGPT can block some risky actions. Use a Business or Enterprise/Edu workspace for write actions.
A code file from HubSpot CMS fails to read
CMS source-code file endpoints return raw files and fail through the read tool. Ask for blog content instead.
Ryze AI says a subscription is required
The HubSpot tools need an active Ryze AI plan or free trial. Start the trial, then retry.

Terms on this page

Custom MCP server
OpenAI's name for a server you add to ChatGPT by its address. MCP stands for Model Context Protocol. The Ryze AI connector is added this way.
Plugin
The installable bundle a custom MCP server becomes in ChatGPT. OpenAI's older pages call the same connection an app or a connector.
Portal
One HubSpot account. Each Ryze AI connection is one portal, and a workspace can hold several.
Scope
A permission an app asks for when it is installed. Each scope opens a set of HubSpot API endpoints and the data behind them.
Filter group
A block of filters in a HubSpot CRM search. Filters inside a group are joined with AND, and the groups are joined with OR.
Recycling bin
Where HubSpot puts deleted CRM records. They can be restored for up to 90 days.
MCP connector (in HubSpot)
The item you create under Development, MCP Connectors to get the client ID and secret for HubSpot's own remote MCP server. The Ryze AI connector does not need one.

Sources: OpenAI: add custom MCP server, OpenAI: plugins in ChatGPT, HubSpot scopes reference, HubSpot CRM search guide, HubSpot: restore deleted records, HubSpot remote MCP server. Checked November 14, 2026.

Frequently asked questions

How do I connect ChatGPT to HubSpot?

Connect HubSpot in a Ryze AI workspace: open Integrations, click Connect on HubSpot, choose the account and approve the permissions. Then on ChatGPT web open Plugins, add a custom MCP server named Ryze AI with the URL https://connector.get-ryze.ai/mcp and OAuth, sign in to Ryze AI, allow the workspace and start a new conversation.

Is there a HubSpot MCP server for ChatGPT?

Yes. The Ryze AI connector at https://connector.get-ryze.ai/mcp has 5 HubSpot tools and is added on ChatGPT web under Plugins. HubSpot runs its own remote MCP server at https://mcp.hubspot.com with 36 documented tools, calls it the server for builders, and runs its ready-made ChatGPT connector on it. Composio and Zapier also host MCP servers with HubSpot actions.

What is the HubSpot MCP server URL for ChatGPT?

For the Ryze AI connector the URL is https://connector.get-ryze.ai/mcp, the same for every user. HubSpot's own remote MCP server is at https://mcp.hubspot.com and needs a client ID and a client secret from an MCP connector that you create in HubSpot under Development, MCP Connectors.

Does HubSpot have its own ChatGPT connector?

Yes. HubSpot's connector for ChatGPT is added under ChatGPT Settings, Apps. It can create and update most CRM objects, 10 records per bulk request at most, and has no delete. HubSpot also runs a remote MCP server at https://mcp.hubspot.com for builders who connect their own client or agent.

Which ChatGPT plan do I need?

OpenAI says custom MCP server connections and full MCP support are available to ChatGPT Business and Enterprise/Edu customers on web. Pro users can connect custom MCP servers with read and fetch permissions only. OpenAI's article does not mention Free, Go or Plus.

Can I connect ChatGPT Plus to HubSpot with a custom MCP server?

OpenAI's help article on custom MCP servers does not name Plus. It gives full MCP to Business and Enterprise/Edu and read and fetch permissions to Pro. OpenAI's pricing page has a row named Developer mode (beta) with a yes for Plus, but the page does not say what the row covers and never uses the word MCP. HubSpot's article for its own ChatGPT connector names no ChatGPT plan either: it says the connector is available to all HubSpot customers with an OpenAI account.

Who can add Ryze AI to a Business workspace?

On Business, only admins and owners can create and publish plugins for custom MCP servers. Members cannot add Ryze AI themselves until an admin publishes it. On Enterprise/Edu, admins can also grant members permission through role-based access control.

What HubSpot permissions do I need?

You need to be a Super Admin or have App Marketplace Access in HubSpot. Otherwise a Super Admin has to connect HubSpot in Ryze AI for you.

Can ChatGPT edit or delete HubSpot records?

Through Ryze AI, yes on plans with write access: it can create and update contacts, companies, deals and blog posts, and delete records or blog posts when you ask. Most CRM deletes go to HubSpot's recycling bin, and deleted blog posts may not be recoverable. Pro accounts are read only.

Can ChatGPT read HubSpot tickets through Ryze AI?

No. A ticket search through the Ryze AI connection was refused in the test on November 14, 2026, and tickets are not among the permissions Ryze AI documents for HubSpot. HubSpot's own connector for ChatGPT reads, creates and updates tickets.

Can I connect more than one HubSpot account?

Yes. Click View on the HubSpot card in Ryze AI and choose Add one more account. The starred account is the primary and is used unless you name another in chat.

Does this work on the ChatGPT mobile app?

Not for the setup. OpenAI says custom MCP servers cannot be connected on mobile, so add Ryze AI on ChatGPT web. OpenAI's pages do not say whether a plugin made from a custom MCP server then works in the mobile app.

Why do the HubSpot tools not show up in ChatGPT?

ChatGPT keeps a snapshot of the server's tools. Open the server in Plugins and select Refresh, or remove it, install it again and start a new chat. In a Business or Enterprise/Edu workspace an admin must also publish the update.

How much does it cost to connect ChatGPT to HubSpot?

Adding the connector costs nothing, but the HubSpot tools need an active Ryze AI plan or free trial. Paid Ads is $89 per month with a 7-day free trial, Agency is $279 per month, and SEO Starter is $129 per month with a 3-day free trial. Annual billing takes 30% off the first year.

How do I disconnect HubSpot from ChatGPT?

In ChatGPT, open Settings, Plugins, select Ryze AI and choose Disconnect next to the connected account. OpenAI's pages differ on whether uninstalling a plugin also disconnects it, so use Disconnect. To cut HubSpot off at the source, disconnect the portal in Ryze AI with the trash icon on the HubSpot card, or uninstall the app in HubSpot.

Connect HubSpot to ChatGPT

One Ryze AI workspace holds your HubSpot connection and the other platforms you connect. Paid Ads is $89 per month with a 7-day free trial; annual billing takes 30% off the first year.

HubSpot MCP server

Need help? Read the Ryze AI ChatGPT guide or email Ryze AI support.