By Ira Bodnar, Ryze AI · Updated
Quick answer
To connect ChatGPT to HubSpot, 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, 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
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. 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. Install the plugin.
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 Ryze AI help article for HubSpot covers the HubSpot side of the connection, and the Ryze AI ChatGPT guide covers the ChatGPT side.
The legacy custom app flow
The Ryze AI help center still documents the earlier flow, which creates a custom app under Settings. OpenAI's own docs now describe Plugins, so try Plugins first. If your workspace still shows the app flow, these steps apply:
- Open Settings, Apps, Advanced settings and turn on Developer mode.
- Click Create app.
- Name it Ryze AI, set the MCP server URL to https://connector.get-ryze.ai/mcp (keep Server URL, not Tunnel) and choose OAuth.
- Tick I understand and want to continue, then click Create.
- Click Sign in with Ryze AI, log in, choose workspaces and click Allow connection.
- Start a new chat.
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.
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 9, 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 run as the HubSpot account you connected. The installing user's login decides how much of the portal the connection reaches, so connect with a login whose reach you are comfortable sharing.
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.
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. In ChatGPT, remove or uninstall the Ryze AI plugin or app.
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, write actions may ask for confirmation depending on app permissions, and on Pro they are not available at all.
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.
Ryze AI vs HubSpot's own ChatGPT connector and MCP server
HubSpot has its own ChatGPT connector and a remote MCP server, in addition to the Ryze AI connector. They suit different jobs.
| Option | Setup | HubSpot coverage | Limits |
|---|---|---|---|
| Ryze AI connector | HubSpot sign-in inside Ryze AI, then one custom MCP server URL in ChatGPT Plugins | Contacts, companies and deals, contact lists, owners and CMS blog content. Read, create, update and delete | Needs a Ryze AI plan or trial, and a ChatGPT plan that allows custom MCP servers |
| HubSpot connector for ChatGPT | ChatGPT Settings, Apps, HubSpot, Connect, then sign in to HubSpot. Super Admins and users with App Marketplace Access connect directly; others need Super Admin approval | Contacts, companies, deals, tickets, custom objects, campaigns, landing pages, blog posts, marketing emails and engagement records. Create and update most objects | No delete; 10 records per bulk request; no sensitive data properties or deleted records; draft pages show metadata only |
| HubSpot remote MCP server | Create an MCP connector in HubSpot under Development, MCP Connectors, then give your client the URL https://mcp.hubspot.com, a client ID and secret. OAuth with PKCE | Read and write on CRM records, activities, marketing content and more, depending on the scopes granted | 200 results per search; no vector search, joins or currency conversion |
If you only work with HubSpot records, HubSpot's own connector is simpler: it needs no Ryze AI account and works from Settings, Apps. Pick Ryze AI when you want delete, CMS blog editing and publishing to a chosen blog and author, or several HubSpot portals in one connection.
Sources: HubSpot connector for ChatGPT, HubSpot remote MCP server, Ryze AI HubSpot integration. Checked November 9, 2026.
HubSpot errors and fixes
- 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.
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.
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, limited to 10 records per request, and has no delete. HubSpot also runs a remote MCP server at https://mcp.hubspot.com for other MCP clients.
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.
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 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?
No. OpenAI says custom MCP servers cannot be connected on mobile. Set Ryze AI up on ChatGPT web.
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?
Remove the Ryze AI plugin or app in ChatGPT. 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.