By Ira Bodnar, Ryze AI · Updated ·
Quick answer
To connect Cursor to HubSpot, link your HubSpot account in Ryze AI with HubSpot's own sign-in, then add https://connector.get-ryze.ai/mcp to Cursor with the Add to Cursor link or a url entry in mcp.json, and sign in when Cursor asks. Cursor then has 5 HubSpot tools.
- In Ryze AI open Integrations, find HubSpot and click Connect
- Sign in to HubSpot, choose the account (portal) and approve the permissions
- In Cursor add the Ryze AI server (Add to Cursor link or mcp.json) and finish the sign-in
- Start a new Cursor chat and ask about your contacts, companies or deals
Cursor to HubSpot at a glance
| Fact | Detail |
|---|---|
| Main way to connect | The Ryze AI connector: one hosted MCP address, added to Cursor with a link or one entry in mcp.json |
| Server address | https://connector.get-ryze.ai/mcp |
| Sign-in to Cursor | In the browser, through OAuth with PKCE. Cursor registers itself, so there is no client ID or secret to paste. A Ryze AI API key in a header also works |
| Sign-in to HubSpot | HubSpot OAuth, done once in Ryze AI. You choose the account (portal) and approve the permissions |
| HubSpot tools | 5: three read, one write, one delete |
| Can it change HubSpot | Yes, through the write and delete tools. Cursor asks before each MCP tool call by default |
| Cursor plan needed | Cursor's MCP documentation names none |
| Ryze AI price | Paid Ads is $89 per month with a 7-day free trial. Adding the connector is free |
| HubSpot's own server | https://mcp.hubspot.com, with OAuth. HubSpot's documentation does not name Cursor as a client |
| Not covered | Custom objects and list editing are not claimed. Each connection is one HubSpot portal |
| Last checked | November 13, 2026 |
Before you start
- A Cursor install. Cursor's MCP documentation names no plan for using MCP servers. On Enterprise, admins can control which MCP servers users may run in Team Settings > MCP Configuration, so a blocked server needs an admin to allow it.
- Permission to connect apps in HubSpot. The HubSpot sign-in asks you to approve the permissions that Ryze AI requests. If your HubSpot user cannot approve an app, ask a Super Admin to connect the account. HubSpot's MCP page also says all actions respect your existing HubSpot user permissions.
- A Ryze AI workspace on a plan or free trial. Paid Ads is $89 per month with a 7-day free trial; SEO Starter is $129 per month with a 3-day free trial and covers publishing Content Plan articles to a HubSpot blog. Adding the connector is free, but the HubSpot tools need an active plan or trial.
How to connect Cursor to HubSpot
Two steps happen in Ryze AI and HubSpot, two in Cursor, and the last is your first prompt. 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 account and approve the permissions
Sign in to HubSpot, choose the account (portal) and click Choose Account. HubSpot lists the permissions Ryze AI requests. Approve them and HubSpot returns you to Ryze AI with the connection saved.
Add the Ryze AI server to Cursor
Either use the Add to Cursor link on the Ryze AI developers page, which opens a cursor:// install link for a server named ryze at https://connector.get-ryze.ai/mcp, or create ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project) with the url entry shown below.
{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }Sign in from Cursor
Confirm the install in Cursor. Cursor runs OAuth with PKCE and dynamic client registration, so there is no client ID or secret to enter. Sign in on the Ryze AI page and click Allow connection. You can manage or toggle the server from the Customize page in the sidebar.
Ask your first question in Cursor
Start a new chat in Cursor, approve the tool call when Cursor asks, and try: List the HubSpot deals I own that are still open, with deal name, amount and stage.
The Ryze AI help center page for HubSpot covers the HubSpot side of the connection. Cursor does not have its own Ryze AI help page; the Ryze AI developers page has the Add to Cursor link and the matching config.
Sources: Cursor MCP documentation, Ryze AI HubSpot guide. Checked November 13, 2026.
mcp.json, API key and Cloud Agents
mcp.json
Save this as ~/.cursor/mcp.json for every project or .cursor/mcp.json for one project. Cursor accepts remote servers through the url field and handles the OAuth sign-in itself.
{
"mcpServers": {
"ryze": {
"url": "https://connector.get-ryze.ai/mcp"
}
}
}Cursor supports stdio, SSE and Streamable HTTP transports. For OAuth it reads the server's protected resource metadata (RFC 9728) and registers as a public client through dynamic client registration. After sign-in, manage or toggle the server from the Customize page in the sidebar.
mcp.json with a Ryze AI API key
If you prefer a key to the browser sign-in, add a headers entry and set RYZE_API_KEY in your environment to the rk_live_ key from Ryze AI under Workspace Settings > Profile > API keys. Keep the key out of files you commit.
{
"mcpServers": {
"ryze": {
"url": "https://connector.get-ryze.ai/mcp",
"headers": {
"Authorization": "Bearer ${env:RYZE_API_KEY}"
}
}
}
}Cloud Agents
Cursor Cloud Agents keep their own MCP sign-ins on Cursor's servers, separate from the sign-in on your desktop. If a Cloud Agent needs your CRM data, connect the Ryze AI server for it as well.
Cursor and MCP: the facts in one table
| Topic | What Cursor's documentation says |
|---|---|
| Config files | .cursor/mcp.json inside a project, or ~/.cursor/mcp.json for every project |
| Transports | stdio, SSE and Streamable HTTP |
| Sign-in | OAuth with PKCE. Cursor reads the server's protected resource metadata (RFC 9728) and registers as a public client through dynamic client registration |
| Tool approval | Cursor asks before it uses an MCP tool by default and follows the same Run Modes as terminal commands |
| Where servers are managed | The Customize page in the sidebar. Enterprise admins use Team Settings > MCP Configuration |
| Cloud Agents | They keep their own MCP sign-ins on Cursor's servers |
Sources: Cursor MCP documentation. Checked November 13, 2026.
Claude and ChatGPT
The same URL works in other MCP clients. HubSpot is connected once in Ryze AI, so nothing changes on the HubSpot side.
Claude
Add https://connector.get-ryze.ai/mcp as a custom connector under Customize > Connectors, pick the workspaces and start a new chat. A separate guide covers Claude and HubSpot, linked below.
ChatGPT
Add the same URL as an app under Settings > Apps, pick the workspaces and start a new chat. If the connector was added before HubSpot was connected in Ryze AI, remove and re-add it so the tool list refreshes.
HubSpot access and scope
Two sign-ins are involved: HubSpot for CRM access and Ryze AI for the connector. Three things decide what Cursor can reach.
- Which HubSpot account
- Each connection is one HubSpot portal. You can connect several portals to one workspace; one is the primary (starred) and is used unless you name another, and the tools accept an optional connection_id.
- Which permissions HubSpot grants
- The HubSpot sign-in requests read and write on contacts, companies and deals, read on owners, read on the contact and deal schemas, write on the deal schema, read on lists, and content access for blog posts. Optional scopes include files, CMS functions, knowledge base and membership.
- What Cursor asks first
- Cursor asks for approval before using MCP tools by default, so a record update waits for your click unless you allowlist the tool.
Access behind each action
The table maps what you ask Cursor to do to the HubSpot access involved, using the scopes Ryze AI documents for its HubSpot connection.
| Action in Ryze AI | HubSpot access |
|---|---|
| Read contacts, companies and deals | Read scopes on those objects |
| Create or update a contact, company or deal | Write scopes on those objects |
| Look up account owners | Owners read |
| Read contact lists | Lists read. Editing lists is not claimed |
| Read or edit blog posts | Content scope |
| Add associations between records | Done through the write tool, within the write scopes above |
Removing access
To remove access, disconnect the portal from the HubSpot card in Ryze AI. In Cursor, toggle the ryze server off from Customize or delete its entry from mcp.json.
What Cursor can do in HubSpot
The Ryze AI connector exposes five HubSpot tools: three read, one write and one delete. Writes and deletes are separate tools, so you can approve them separately in Cursor.
| 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. |
Some limits apply in every client, Cursor included. CMS source-code file endpoints return raw files and fail through the read tool. HubSpot returns a default subset of properties unless specific fields are requested, so name the fields you want. Deleted blog posts may not be recoverable, while most CRM deletes go to HubSpot's recycling bin. Tool descriptions mention custom objects, but the requested permissions do not include them, so this page does not claim custom object support.
Cursor asks before it runs an MCP tool by default. Keep that default if you want to review each record edit, or leave the delete tool off your allowlist. Separately, the Ryze AI chat has its own Tool approvals setting that starts on Skip all approvals; you can switch it to Approve write & delete or Manual approve there. Scheduled tasks in Ryze AI run without an approval step.
Limits in numbers
These are HubSpot's own documented API limits. The Ryze AI docs do not say which HubSpot app tier the connection uses, so treat them as the platform's numbers, in HubSpot's units.
| Limit | Number |
|---|---|
| Publicly distributed OAuth apps | Each HubSpot account that installs the app is limited to 110 requests every 10 seconds. HubSpot's page excludes the CRM Search API from this figure. |
| Privately distributed apps, Free and Starter | 100 requests per app every 10 seconds, 250,000 per account per day. |
| Privately distributed apps, Professional | 190 requests per app every 10 seconds, 625,000 per account per day. |
| Privately distributed apps, Enterprise | 190 requests per app every 10 seconds, 1,000,000 per account per day. |
| CRM Search API | 5 requests per second per account. |
| One search page | Up to 200 objects per page, 10,000 results in total for a query. Paging past 10,000 returns a 400 error. |
| Search filters | Up to 5 filter groups with 6 filters each, 18 filters in total. A request over 3,000 characters returns a 400 error. |
| New records in search | New or updated records can take a few moments to appear in search results. |
Sources: HubSpot API usage guidelines, HubSpot CRM search guide. Checked November 13, 2026.
First 3 prompts to run
1. List your open deals
List the HubSpot deals that are still open, with deal name, amount, stage and owner. Sort them by close date.
Tools used: hubspot__search or hubspot__listObjects, hubspot__read for owners
What comes back: A list of deals with the properties you named. Nothing is changed.
2. Find contacts that match a filter
Search HubSpot contacts created in the last 14 days and show first name, last name, email and lifecycle stage.
Tools used: hubspot__search
What comes back: The matching contacts with the chosen properties, through the CRM Search API. Nothing is changed.
3. Update a deal and link a contact
Move the deal named Example deal to the next stage and associate it with the contact with email name@example.com. Read the deal back after the change.
Tools used: hubspot__search, hubspot__write, hubspot__read
What comes back: A write call that updates the deal and adds the association once you approve it in Cursor, then a read so you can compare the stored values with what you asked for.
This page shows no sample output for these prompts. What comes back is your own HubSpot data, so the descriptions say what to expect and nothing more. Replace the example names and the email with your own records.
9 jobs to hand to Cursor
Nine jobs to hand to Cursor, each matched to the tool it uses. Jobs that change HubSpot go through the write or delete tool, which Cursor asks you to approve.
| Job | Ask Cursor | Tool |
|---|---|---|
| Pipeline review | List open deals with amount, stage and close date, grouped by stage. | hubspot__search |
| New contacts | Show contacts created this week with their email and lifecycle stage. | hubspot__search |
| Company lookup | Find the company with this domain and list its contacts and deals. | hubspot__search, hubspot__listObjects |
| Owner check | Which HubSpot owner is assigned to each of these deals? | hubspot__read |
| List read | Read the contact list named in HubSpot and show how many records it returns. | hubspot__read |
| Property definitions | Show the properties available on deals, with their types. | hubspot__read |
| Create a contact | Create a contact with this name and email and associate it with this company. | hubspot__write |
| Edit a blog post | Update the title of the blog post with this ID. | hubspot__write |
| Remove a duplicate | Delete the duplicate contact with this ID after showing me its details. | hubspot__delete |
3 ways to connect Cursor to HubSpot
There are three ways to give Cursor access to HubSpot that this guide checked. The Ryze AI connector is the main way here because the HubSpot sign-in happens once in Ryze AI and Cursor needs only one address. The other two are listed with what each one asks of you.
| Way | Address | Setup in Cursor | What it reaches | Price |
|---|---|---|---|---|
| Ryze AI connector (the main way) | https://connector.get-ryze.ai/mcp | The Add to Cursor link, or a url entry in mcp.json. Sign-in in the browser | 5 tools: list, search and read on contacts, companies and deals, owners, lists and blog posts; write and delete as separate tools | Paid Ads is $89 per month with a 7-day free trial |
| HubSpot remote MCP server | https://mcp.hubspot.com | HubSpot's documentation describes creating an MCP connector in your HubSpot account with a name, description and redirect URL, then connecting an MCP client with OAuth. Its page does not name Cursor, so whether Cursor works with it is unverified | CRM objects, engagements such as calls, emails, meetings, notes and tasks, plus content and marketing assets. Revenue objects are in beta. All actions follow your HubSpot user permissions | HubSpot's page states no separate price; some tools need Marketing Hub Professional or Enterprise |
| Community or custom MCP servers | Varies | A command or url entry in mcp.json, usually with a HubSpot private app token you create | Depends on the server. This guide did not review any | Depends on the server |
Which one to pick
Ryze AI is the best way to connect Cursor to HubSpot for CRM record work and blog content from one address, with one caveat: each connection is one portal, and custom objects and list editing are not claimed. Choose HubSpot's own server when you need its engagement, marketing email or revenue-object tools, which the Ryze AI connector does not list, and when you can set up the MCP connector in your HubSpot account yourself. Cursor can hold several servers at once, so the two can sit side by side in mcp.json.
Sources: HubSpot remote MCP server, HubSpot MCP overview, Cursor MCP documentation, Ryze AI HubSpot guide. Checked November 13, 2026.
Cursor and HubSpot errors and fixes
Common errors
Ryze AI and HubSpot return plain messages. This guide was not run end to end, so these are the common cases and what they mean rather than copied output.
| Situation | What it means | What to do |
|---|---|---|
| A search returns a 400 error | HubSpot rejects a search that pages past 10,000 results, uses more than 18 filters or is longer than 3,000 characters. | Ask Cursor to narrow the filters or the date range. |
| Too many requests | HubSpot rate limits are 5 search requests per second per account, and a burst limit per 10 seconds. | Wait a few seconds and ask again, or ask for fewer records at a time. |
| A CMS source file fails to read | CMS source-code file endpoints return raw files and fail through the read tool. | Read the blog posts or pages through their JSON resources instead. |
| A property is missing from a record | HubSpot returns a default subset of properties unless fields are requested. | Name the properties in the prompt, for example lifecycle stage or deal amount. |
Other problems
- The HubSpot tools do not appear in Cursor
- If HubSpot was connected in Ryze AI after the server was added, remove the ryze entry and add it again, then start a new chat so the tool list refreshes.
- Cursor never asks me to sign in
- Open Customize in the sidebar, find the ryze server and reconnect it. Cursor reads the connector's protected resource metadata and registers itself, so no client ID is needed.
- HubSpot will not let me approve the connection
- Your HubSpot user may lack permission to connect apps. Ask a Super Admin to run the connection, or to grant you the permission.
- Cursor shows the wrong portal
- Each connection is one portal. The primary (starred) portal is used unless you name another in the prompt or pass a connection_id.
- A Cloud Agent cannot reach HubSpot
- Cloud Agents keep their own MCP sign-ins on Cursor's servers. Connect the Ryze AI server for the agent separately from your desktop.
- The server is blocked on a team account
- Enterprise admins can allowlist which servers and tools the team may run. Ask an admin to allow the Ryze AI server in Team Settings > MCP Configuration.
- The tools reply that 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
- MCP
- The Model Context Protocol, an open standard for connecting AI applications to outside systems. Cursor, Claude and ChatGPT support it.
- MCP server
- A program that offers tools over MCP. The Ryze AI connector is an MCP server that runs on Ryze AI's side, so there is nothing to install.
- mcp.json
- The file where Cursor keeps its list of MCP servers.
- Portal
- HubSpot's word for an account. Each Ryze AI HubSpot connection is one portal.
- CRM object
- A type of record in HubSpot, such as a contact, company or deal.
- Association
- A link between two CRM records, such as a contact and the deal it belongs to.
Source for MCP: modelcontextprotocol.io. Checked November 13, 2026.
Frequently asked questions
How do I connect Cursor to HubSpot?
Connect your HubSpot account in Ryze AI under Integrations by signing in to HubSpot, choosing the portal and approving the permissions. Then add https://connector.get-ryze.ai/mcp to Cursor with the Add to Cursor link on the Ryze AI developers page or a url entry in mcp.json, and sign in when Cursor asks.
Is there a HubSpot MCP server for Cursor?
Yes. The Ryze AI connector at https://connector.get-ryze.ai/mcp has 5 HubSpot tools that work on your connected portal. HubSpot also documents its own remote MCP server at https://mcp.hubspot.com, but its page does not name Cursor as a supported client.
What is the HubSpot MCP server URL for Cursor?
For the Ryze AI connector the address is https://connector.get-ryze.ai/mcp, the same for every user. HubSpot's own remote server is at https://mcp.hubspot.com and uses OAuth through an MCP connector that you create in your HubSpot account.
Does HubSpot have an official MCP server?
Yes. HubSpot's developer documentation describes a remote MCP server at https://mcp.hubspot.com with OAuth. It covers CRM objects such as contacts, companies and deals, engagements, and content and marketing assets, and every action follows your HubSpot user permissions. Revenue objects are marked beta.
Which tools does Cursor get for HubSpot?
Five: hubspot__listObjects, hubspot__search and hubspot__read for reading, hubspot__write for creating and updating records, and hubspot__delete for archiving them. Writes and deletes are separate tools, so Cursor can ask about them separately.
Can Cursor edit my HubSpot contacts and deals?
Yes. Through Ryze AI, Cursor can create and update contacts, companies, deals and blog posts and add associations between records with the write tool. Cursor asks for approval before it runs an MCP tool by default.
Can Cursor delete HubSpot records?
Only through the separate hubspot__delete tool, which archives a resource by ID. Most CRM deletes go to HubSpot's recycling bin, but deleted blog posts may not be recoverable. Cursor asks before running MCP tools by default, so you can review each call or keep the delete tool off your allowlist.
Does this support custom objects or editing lists?
This page does not claim either. Tool descriptions mention custom objects, but the permissions Ryze AI requests do not include custom-object scopes, and lists are read only.
Which Cursor plan do I need?
Cursor's MCP documentation names no plan. On Enterprise, admins can control which MCP servers users may run in Team Settings > MCP Configuration.
Can I connect more than one HubSpot portal?
Yes. Several portals can be connected to one workspace. One is the primary and is used unless you name another, and the tools accept an optional connection_id. Each connection is one portal.
Why do the HubSpot tools not show up in Cursor?
If you connected HubSpot in Ryze AI after adding the server, remove the ryze entry from Cursor, add it again and start a new chat so the tool list refreshes.
How much does it cost to connect Cursor 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, SEO Starter is $129 per month with a 3-day free trial, Agency is $279 per month and Shopify CRO is $1,499 per month. Annual billing takes 30% off the first year.
How do I disconnect HubSpot from Cursor?
Disconnect the portal from the HubSpot card in Ryze AI, or toggle the ryze server off from Customize in Cursor, or delete its entry from mcp.json.