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.
- In Ryze AI open Integrations, find HubSpot and click Connect
- Sign in to HubSpot, choose the account and approve the permissions
- In ChatGPT open Plugins, add a custom MCP server with the URL and OAuth
- Sign in to Ryze AI, allow the workspace, then type @ in a new chat
ChatGPT to HubSpot at a glance
| Fact | Detail |
|---|---|
| Main way to connect | The Ryze AI connector: one hosted MCP address that you add on ChatGPT web, under Plugins, as a custom MCP server |
| Server address | https://connector.get-ryze.ai/mcp |
| Sign-in | OAuth 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 tools | 5: 3 read, 1 write, 1 delete |
| Can it change HubSpot | Yes, 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 needed | Business 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 needed | A Super Admin, or a user with App Marketplace Access |
| Ryze AI price | Paid Ads plan: $89 per month, 7-day free trial. No charge for adding the connector |
| HubSpot's own option for ChatGPT | The 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 connection | Contacts, 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 tested | The 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.
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.
Choose the HubSpot account
Sign in to HubSpot, choose the account (portal) you want ChatGPT to work with and click Choose Account.

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.

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.
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.
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.
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:
- Admins and owners open Workspace settings, then Apps, then Create. Members an admin has authorized start from their own settings, then Apps, then Create.
- Name the app Ryze AI and enter https://connector.get-ryze.ai/mcp as the endpoint, with any other details the form asks for.
- Pick OAuth as the authentication mechanism.
- 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.
- Select Create. The draft app shows under Settings, Apps, Enabled Apps, with the label Dev next to its name.
- 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:
- Connect and test Ryze AI as described above.
- Open Admin Console, select the workspace, then Plugins, Manage Legacy Apps, Drafts and Publish. Review the safety warnings for write actions.
- On Enterprise/Edu, use Configure Actions and Configure Access before publishing if you want to limit what members can do.
- 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
| Topic | What OpenAI's pages say |
|---|---|
| Where the server goes | ChatGPT on the web: Plugins (chatgpt.com/plugins), the plus button, Add custom MCP server. Web chats read no config file |
| Transports | SSE and streaming HTTP. The web form takes a Server URL or a Tunnel, never a local command |
| Sign-in choices | OAuth, No authentication, or OAuth or no authentication. OpenAI's authentication guide says ChatGPT cannot present custom API keys |
| How the OAuth sign-in runs | ChatGPT 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 approval | Write actions need confirmation by default, and a tool without the readOnlyHint annotation counts as a write action |
| Permission settings | Always 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 |
| Plan | Full 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 workspace | Business: 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 managed | Settings, Plugins, where each connected account has Reconnect and Disconnect. Admins use Admin console, the workspace, then Plugins |
| Desktop app | Settings, 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.
| Limit | What it means |
|---|---|
| Web only | Custom MCP servers cannot be connected on mobile. Set Ryze AI up on ChatGPT web. |
| Pro is read only | Pro accounts get read and fetch permissions, so creating or updating HubSpot records needs a Business or Enterprise/Edu workspace. |
| Confirmations | Write actions may ask for confirmation based on app permissions and context, and some risky actions may be blocked. |
| Deep research | Deep research can use custom apps for read and fetch actions only. |
| Company knowledge | Company knowledge includes only apps that have search and fetch functions. |
| Tool list refresh | For 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.
| Access | Level |
|---|---|
| Contacts, companies and deals | Read and write |
| Owners | Read |
| Contact schema | Read |
| Deal schema | Read and write |
| Lists | Read |
| Content (blog posts) | Required |
| Files, CMS functions, knowledge base, membership | Optional |
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.
| Access | Matching entry in HubSpot's scope list | HubSpot's description | Offered to |
|---|---|---|---|
| Contacts, read and write | crm.objects.contacts.read, crm.objects.contacts.write | View contact properties and details. Create, delete and change contacts | All accounts |
| Companies, read and write | crm.objects.companies.read, crm.objects.companies.write | View company properties and details. Create, delete or change companies | All accounts |
| Deals, read and write | crm.objects.deals.read, crm.objects.deals.write | View deal properties and details. Create, delete or change deals | All accounts |
| Owners, read | crm.objects.owners.read | View details about users assigned to a CRM record | All accounts |
| Contact schema, read | crm.schemas.contacts.read | View property settings for contacts | All accounts |
| Deal schema, read and write | crm.schemas.deals.read, crm.schemas.deals.write | View, create, delete or change property settings for deals | All accounts |
| Lists, read | crm.lists.read | View details about contact lists | All accounts |
| Content | content | HubSpot's content APIs, which include website pages, landing pages and blogs | CMS Hub or Marketing Hub, Professional or Enterprise |
| Files, optional | files | A legacy scope for the HubSpot file manager | All accounts |
| CMS functions, optional | cms.functions.read, cms.functions.write | Content Hub serverless functions and secrets | Content Hub Enterprise |
| Knowledge base, optional | cms.knowledge_base.articles.read and related scopes | View details about knowledge articles | Service Hub Professional or Enterprise |
| Membership, optional | cms.membership.access_groups.read, cms.membership.access_groups.write | View, create, edit and delete membership access groups | Service 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.
| Tool | Type | What it does |
|---|---|---|
| hubspot__listObjects | Read | Lists CRM records of one object type page by page, with the properties you choose and the IDs of associated records. |
| hubspot__search | Read | Searches CRM records through the HubSpot CRM Search API with filter groups, sorts, a text query and chosen properties. |
| hubspot__read | Read | Sends a GET request to any HubSpot JSON API resource, such as a record, property definitions, owners, a list or blog posts. |
| hubspot__write | Write | Creates or updates a HubSpot resource, such as a contact, company, deal or blog post, and adds associations between records. |
| hubspot__delete | Delete | Deletes (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
| Limit | Detail |
|---|---|
| Records per search page | 10 by default and 200 at most. hubspot__search passes your limit on to HubSpot, which rejected 201 in the test |
| Results per search query | 10,000 in total. HubSpot answers a request for anything past that with a 400 error |
| Filters in one search | 5 filter groups with up to 6 filters each, and 18 filters in total |
| Filter operators in hubspot__search | 12: EQ, NEQ, GT, GTE, LT, LTE, BETWEEN, IN, NOT_IN, HAS_PROPERTY, NOT_HAS_PROPERTY and CONTAINS_TOKEN |
| Length of one search | 3,000 characters at most. A longer request body gets a 400 error |
| Search requests per second | 5 per HubSpot account |
| Search freshness | A new or changed record can take a few moments to show up in search. Archived records never show up |
| Fields a search returns unasked | Contacts: 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 page | 100 contacts in one request, which is also the highest limit hubspot__listObjects accepts |
| Requests per 10 seconds | 110 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 records | Restorable from the recycling bin for up to 90 days |
| HubSpot's own ChatGPT connector | 10 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.
| Call | What was sent | What came back |
|---|---|---|
| hubspot__search on contacts, companies and deals | 3 calls, each with a filter for an email, a domain or a deal name equal to 20 random letters | All 3 worked and returned the empty result {"total":0,"results":[]} |
| hubspot__listObjects on contacts | Limit 1 and the single property hs_object_id | Worked. 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 property | A contact filter on a property name that does not exist | Refused with Error 400 |
| hubspot__search with limit 201 | A contact search that asked for 201 records per page | Refused with Error 400, category VALIDATION_ERROR |
| hubspot__search on tickets | A ticket filter that could not match | Refused with the status not_allowed |
| hubspot__read of a deal | The path crm/v3/objects/deals/0 | The status not_found |
| hubspot__read of a contact | A contact path ending in an 18-digit ID that does not exist | The status not_found. HubSpot sent an HTML 404 page |
| hubspot__read of a blog post, twice | The path cms/v3/blogs/posts/ with 2 made-up post IDs | The 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.
| Job | Ask ChatGPT | Tool | Works on the default connection |
|---|---|---|---|
| Look up a contact | Find the HubSpot contact with this email and show their job title and lifecycle stage. | hubspot__search | Yes |
| Deals from the last 30 days | List the deals created in the last 30 days with name, amount and stage. | hubspot__search | Yes |
| Stalled deals | Find open deals with no change in 30 days and name the owner of each. | hubspot__search, then hubspot__read for owners | Yes. The owners read was not part of the test |
| Company overview | Find the company with this domain and list its associated contacts and deals. | hubspot__search, then hubspot__listObjects with associations | Yes. Associations were not requested in the test |
| Contacts page by page | Go through my contacts 100 at a time and show lifecycle stage and create date for each. | hubspot__listObjects | Yes |
| Property check | Show which contact and deal properties exist before you build a filter. | hubspot__read | Yes. Not part of the test |
| Create a deal | Create a deal for this company and associate it with its main contact. | hubspot__write | Yes, with full MCP in ChatGPT. Not run in the test |
| Update a record | Move this deal to the stage I name, then read the deal back to me. | hubspot__write, then hubspot__read | Yes, with full MCP in ChatGPT |
| Remove a duplicate | Delete the contact with this ID. | hubspot__delete | Yes, with full MCP in ChatGPT. Most CRM deletes land in the recycling bin, where they stay restorable for up to 90 days |
| Ticket search | List the open tickets for this company. | hubspot__search | No. 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.
| Way | Runs where | Setup in ChatGPT | What it reaches in HubSpot | Price |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Hosted, one address for every user | On 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 AI | Contacts, 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 ChatGPT | Hosted by HubSpot, used inside ChatGPT | Profile 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 first | Contacts, 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 beta | HubSpot states no price: all HubSpot customers on every tier with an OpenAI account |
| HubSpot remote MCP server | Hosted by HubSpot at https://mcp.hubspot.com | HubSpot 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 instead | 36 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 conversion | HubSpot states no price. Open to all HubSpot accounts since April 13, 2026 |
| Composio | Hosted | Install 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 authenticate | 354 HubSpot tools and 2 triggers, to read and to write, by Composio's count | Per its pricing page: free with 10,000 tool calls a month, or Standard at $18 per seat per month |
| Zapier MCP | Hosted | Plugins, Add, Create custom MCP server, the name Zapier MCP, the connection https://mcp.zapier.com/api/v1/connect and OAuth | The HubSpot actions you enable in your Zapier account. Zapier prints no total | Each 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.ai | Hosted | Connect HubSpot as a data source in Windsor.ai, then add Windsor MCP from the Plugins list in ChatGPT | Reporting data: 1,141 HubSpot fields, of which 287 are metrics and 854 dimensions. Its MCP page names no write action for HubSpot | Included on every plan. The free plan covers 1 data source, and Basic is $23 per month on monthly billing |
| Coupler.io | Hosted | Build 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 integrations | Read-only analysis of the HubSpot datasets your flows load, as aggregated data without individual records | Free 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
| Date | What happened |
|---|---|
| June 4, 2025 | HubSpot 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, 2025 | The remote HubSpot MCP server went into its initial public beta. |
| October 17, 2025 | OpenAI began rolling out full MCP support, with read and write, in beta for Business, Enterprise and Edu. |
| April 13, 2026 | The remote HubSpot MCP server became generally available to all HubSpot accounts, with write access added and OAuth 2.1 with PKCE required. |
| July 9, 2026 | The Plugin Directory replaced the App Directory in ChatGPT. Existing app connections were not affected. |
| October 1, 2026 | Admins 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, 2026 | HubSpot 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, 2026 | HubSpot 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 run | What 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.
| Message | What it means | What 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.