How to connect Cursor to HubSpot

Connect your HubSpot account once in Ryze AI, add one MCP URL to Cursor, then ask Cursor about contacts, companies, deals and blog posts.

Your MCP URL
https://connector.get-ryze.ai/mcpAdd to Cursor

Copies the link and opens the Cursor install prompt for the ryze server. See the steps

See pricing

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

Quick answer

The main way to connect Cursor to HubSpot is the Ryze AI connector. Approve HubSpot once inside Ryze AI with HubSpot's own sign-in, then add https://connector.get-ryze.ai/mcp to Cursor through the Add to Cursor link or a url entry in mcp.json, and finish the browser sign-in when Cursor opens it. Cursor then has 5 HubSpot tools for contacts, companies, deals, owners, contact lists and blog posts.

  1. In Ryze AI open Integrations, find HubSpot and click Connect
  2. Sign in to HubSpot, choose the account (portal) and approve the permissions
  3. In Cursor add the Ryze AI server (Add to Cursor link or mcp.json) and finish the sign-in
  4. Start a new Cursor chat and ask about your contacts, companies or deals

Cursor to HubSpot at a glance

FactDetail
Main way to connectThe Ryze AI connector, a hosted MCP server. Cursor needs one url entry in mcp.json or one click on the Add to Cursor link
Server addresshttps://connector.get-ryze.ai/mcp
Sign-in from CursorOAuth with PKCE in the browser. Cursor registers itself as a client, so you paste no client ID or secret. A Ryze AI API key in a headers entry is the alternative
Sign-in to HubSpotHubSpot's OAuth screen, opened once from Ryze AI. A Super Admin or a user with App Marketplace access picks the portal and approves the permissions
HubSpot tools5: hubspot__listObjects, hubspot__search and hubspot__read look things up, hubspot__write creates or updates, hubspot__delete archives
Can Cursor change HubSpotYes, through the write and delete tools. By default Cursor stops and asks before every MCP tool call
Cursor plan neededNone is named in Cursor's MCP documentation
Ryze AI pricePaid Ads is $89 per month with a 7-day free trial. Adding the connector is free
HubSpot's own options for CursorThe READMEs of the Agent CLI skills and of the older @hubspot/mcp-server package name Cursor. The Developer MCP server lists Cursor but has no CRM record tools. The remote server at https://mcp.hubspot.com takes any MCP client with OAuth and PKCE without naming Cursor. HubSpot's ready-made assistant connectors leave Cursor out
Outside the Ryze AI accessTickets (refused in the test), custom objects and list editing. Each connection is one HubSpot portal
Last testedConnector sign-in details on November 13, 2026, and 11 read-only HubSpot calls on November 14, 2026. No step was run inside Cursor

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 install apps in HubSpot. HubSpot lets a Super Admin, or a user who holds App Marketplace access, approve an app such as Ryze AI. If your HubSpot user has neither, ask a Super Admin to connect the account. What the connection can then reach follows the scopes Ryze AI requests, as HubSpot's OAuth guide explains; the record limits of the person who clicked approve do not narrow it.
  • 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.

  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 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.

  3. 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" } } }
  4. 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.

  5. 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, checked November 13, 2026; Ryze AI HubSpot guide, checked November 14, 2026.

mcp.json, API key and Cloud Agents

mcp.json

Put this entry in ~/.cursor/mcp.json to reach HubSpot from every project, or in .cursor/mcp.json to keep it to one repository. A url field is all Cursor needs for a hosted server, and Cursor runs the OAuth sign-in itself. No HubSpot token or key goes into the file, because HubSpot is approved inside Ryze AI.

{ "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

To skip the browser sign-in, add a headers entry and store the rk_live_ key from Ryze AI (Workspace Settings > Profile > API keys) in an environment variable named RYZE_API_KEY. Cursor swaps ${env:RYZE_API_KEY} for the value of that variable, so the key itself never sits in a file you might commit.

{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp", "headers": { "Authorization": "Bearer ${env:RYZE_API_KEY}" } } } }

Cloud Agents

Cloud Agents hold MCP sign-ins of their own on Cursor's servers, apart from the one on your desktop. A Cloud Agent that should look up HubSpot records needs the Ryze AI server connected for it separately.

Cursor and MCP: the facts in one table

TopicWhat Cursor's documentation says
Where the server entry goes~/.cursor/mcp.json for all projects, or .cursor/mcp.json inside one project's folder
Fields of a hosted entryurl, and a headers object when a key or token has to travel with each request
Transportsstdio, SSE and Streamable HTTP
Sign-in to a hosted serverOAuth. Cursor signs itself up as a public client without a secret through dynamic client registration, or uses static OAuth client credentials written into mcp.json
Values Cursor fills in${env:NAME}, ${userHome}, ${workspaceFolder}, ${workspaceFolderBasename} and ${pathSeparator}
Approval of tool callsCursor asks first by default. Auto-review mode runs allowlisted MCP tools at once and sends every other call through its classifier
MCP featuresTools, resources, prompts and elicitation
Where servers are switched on and offCustomize in the sidebar. Admins use Dashboard > Plugins & MCPs and Team Settings > MCP Configuration, and Enterprise admins can limit servers with an MCP Allowlist
Cloud AgentsThey can use MCP servers, with sign-ins kept apart from the desktop app
Install link formatcursor://anysphere.cursor-deeplink/mcp/install?name=$NAME&config=$BASE64_ENCODED_CONFIG
Plan, server or tool limitsCursor's MCP page states none of them

Sources: Cursor MCP documentation, Cursor MCP install links. 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 a custom MCP server from Plugins, with OAuth as the sign-in, choose the workspaces at the Ryze AI sign-in and start a new conversation. OpenAI's help center offers full custom MCP support on Business and Enterprise/Edu, and read and fetch only on Pro. If the server was added before HubSpot was connected in Ryze AI, remove and add it again so the tool list refreshes.

HubSpot access and scope

Two sign-ins are involved: HubSpot's, done once in Ryze AI, and the Ryze AI sign-in that Cursor starts. Four things decide what Cursor can reach in HubSpot.

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 the token covers
HubSpot's OAuth guide says an access token reflects the scopes the app requested and does not reflect what the approving user may do in HubSpot. Its own example: a user who can view only the contacts they own can still authorize a token that reads every contact in the account.
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 AIHubSpot access
Read contacts, companies and dealsRead scopes on those objects
Create or update a contact, company or dealWrite scopes on those objects
Look up account ownersOwners read
Read contact listsLists read. Editing lists is not claimed
Read or edit blog postsContent scope
Add associations between recordsDone through the write tool, within the write scopes above

The HubSpot scopes behind the Ryze AI connection

Ryze AI words its HubSpot access as eight required parts and four optional ones. For each part, the table gives the entry in HubSpot's scope reference that matches it, what HubSpot says that entry allows, and which HubSpot accounts have it. The exact scope strings inside the Ryze AI app were not read for this guide; HubSpot's consent screen shows them when you approve. The Ryze AI listing in the HubSpot Marketplace names eight kinds of shared data that line up with the required parts: contacts, contact properties, companies, deals, deal properties, contact lists, owners and CMS blog posts.

What Ryze AI asks forHubSpot scope entryWhat HubSpot says it allowsWhich accounts have it
Contacts, read and write (required)crm.objects.contacts.read, crm.objects.contacts.writeView contact details; create, delete and change contactsAll accounts
Companies, read and write (required)crm.objects.companies.read, crm.objects.companies.writeView company details; create, delete and change companiesAll accounts
Deals, read and write (required)crm.objects.deals.read, crm.objects.deals.writeView deal details; create, delete and change dealsAll accounts
Owners, read (required)crm.objects.owners.readSee which users are assigned to a CRM recordAll accounts
Contact schema, read (required)crm.schemas.contacts.readSee how contact properties are configuredAll accounts
Deal schema, read and write (required)crm.schemas.deals.read, crm.schemas.deals.writeSee and change how deal properties are configuredAll accounts
Lists, read (required)crm.lists.readSee the details of contact listsAll accounts
Content (required)contentContent APIs such as website pages, landing pages and blogsCMS Hub or Marketing Hub, Professional or Enterprise
Files (optional)filesThe file manager, through a legacy scope; HubSpot asks existing apps to move to granular scopes such as files.readAll accounts
CMS functions (optional)cms.functions.read, cms.functions.writeContent Hub serverless functions and their secretsContent Hub Enterprise
Knowledge base (optional)cms.knowledge_base.articles.read and related entriesKnowledge articles, read through the GraphQL APIService Hub Professional or Enterprise
Membership (optional)cms.membership.access_groups.read, cms.membership.access_groups.writeMembership access groupsService Hub or Content Hub, Professional or Enterprise

Required and optional parts behave differently at install. If the chosen portal cannot grant a required scope, HubSpot shows an error and the install does not finish. An optional scope the portal lacks is dropped from the request without a prompt. Whether a portal below CMS Hub or Marketing Hub Professional can finish the Ryze AI install was not tested for this guide.

Not part of the Ryze AI access: tickets, custom objects, list editing (crm.lists.write), company property settings (crm.schemas.companies.read) and the Sensitive Data scopes, which HubSpot lists as separate entries. A ticket search through Ryze AI was refused on November 14, 2026. Tickets and custom objects are within reach of HubSpot's Agent CLI, whose skills README names Cursor, and of HubSpot's remote MCP server, whose page does not name Cursor. The ways table below has both.

Sources: HubSpot scopes, HubSpot OAuth guide, Installing apps in HubSpot, Ryze AI in the HubSpot Marketplace, Ryze AI HubSpot guide. Checked November 14, 2026.

Removing access

To cut access, click View on the HubSpot card in Ryze AI and use the trash icon next to the portal. Inside HubSpot you can also uninstall the app under Settings, Integrations, Connected Apps, Actions, Uninstall, then type uninstall to confirm. In Cursor, switch 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. Each takes a workspace and an optional connection_id that picks one of the connected portals. Writes and deletes are separate tools, so you can approve them separately in Cursor.

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.

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. If you switch Cursor to Auto-review, allowlisted tools run at once and the rest go through Cursor's classifier, so keep hubspot__write and hubspot__delete off that allowlist when you want them checked. 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

HubSpot sets most of these numbers, in its own units; the hubspot__listObjects and path rows come from the Ryze AI tool definitions. The first row is HubSpot's rule for OAuth apps distributed through the HubSpot Marketplace. Ryze AI signs in with OAuth and has a Marketplace listing, yet HubSpot's page does not name Ryze AI, and no response in the test carried a rate limit header. That row gives HubSpot's general rule, and no call in the test measured it for Ryze AI.

LimitNumber
Publicly distributed OAuth appsEach 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, and its API limit increase add-on does not raise it.
Privately distributed apps, Free and Starter100 requests per app every 10 seconds, 250,000 per account per day.
Privately distributed apps, Professional190 requests per app every 10 seconds, 625,000 per account per day.
Privately distributed apps, Enterprise190 requests per app every 10 seconds, 1,000,000 per account per day.
Past a limitHubSpot answers 429 to every later call. The daily count resets at midnight in the account's time zone, and errors should stay under 5% of a day's requests.
CRM Search API5 requests per second per account. Search responses carry no rate limit headers.
One search page10 records when no limit is given, 200 at most. hubspot__search passes the limit on, and a request for 201 was refused in the test.
Results per search query10,000 in total. Paging past 10,000 returns a 400 error.
Search filtersUp 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 searchNew or updated records can take a few moments to appear in search results. Archived records never appear there.
hubspot__listObjectsUp to 100 records per page, which is also the most contacts HubSpot returns in one request.
Path in read, write and deleteUp to 2,048 characters.
Access tokenExpires after 30 minutes; the app renews it with the refresh token.
Recycling binDeleted CRM records can be restored for 90 days. Permanent and GDPR deletions skip the bin.

Sources: HubSpot API usage guidelines, HubSpot CRM search guide, HubSpot contacts API, HubSpot OAuth tokens, Restoring deleted records, the Ryze AI tool definitions. Checked November 14, 2026.

What the default connection answered, tested

Each row is one read-only call that went through the Ryze AI connector on November 14, 2026, to a HubSpot portal linked with the default connection. The calls were sent from Claude Code, which reaches the same server and tools that Cursor uses. Filters were built to match nothing and IDs were made up, so no record from that portal is shown.

RequestTool and inputWhat came back
Find a contact by emailhubspot__search, email EQ a random string of 20 lettersA valid empty answer: {"total":0,"results":[]}
Find a company by domainhubspot__search, domain EQ 20 random lettersValid, in the same empty shape
Find a deal by namehubspot__search, dealname EQ 20 random lettersValid, in the same empty shape
Page through contactshubspot__listObjects, limit 1, property hs_object_idOne result with id, properties, createdAt, updatedAt, archived and url, plus paging.next with after and link. HubSpot added createdate and lastmodifieddate unasked
Filter on a property that is not therehubspot__search on contacts with a made-up property nameRefused, Error 400
Ask for 201 search resultshubspot__search on contacts, limit 201, a filter that cannot matchRefused, Error 400 with the category VALIDATION_ERROR
Search ticketshubspot__search on tickets, a filter that cannot matchRefused with status not_allowed
Read deal 0hubspot__read of crm/v3/objects/deals/0status not_found
Read a contact that does not existhubspot__read of a contact path with an 18-digit IDstatus not_found, after HubSpot sent back an HTML 404 page
Read a blog post that does not existhubspot__read of cms/v3/blogs/posts/ with an 18-digit IDstatus not_found, the same HTML 404
Read blog post 1hubspot__read of cms/v3/blogs/posts/1status not_found once more. Neither blog call shows whether blog reads work on that portal

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.

10 jobs to hand to Cursor

Ten jobs for Cursor, each with the HubSpot tool behind it and whether the default Ryze AI connection can do it. In the November 14, 2026 test, searches and the contact list ran with inputs that returned nothing or one record. The owner, list and property reads and every change were not run. Jobs that change HubSpot go through the write or delete tool, which Cursor asks you to approve.

JobAsk CursorToolOn the default connection
Pipeline reviewList open deals with amount, stage and close date, grouped by stage.hubspot__searchYes
New contactsShow contacts created this week with their email and lifecycle stage.hubspot__searchYes
Company lookupFind the company with this domain and list its contacts and deals.hubspot__search, hubspot__listObjectsYes. Associations were not asked for in the test
Owner checkWhich HubSpot owner is assigned to each of these deals?hubspot__read on crm/v3/ownersYes. Not run in the test
List readRead the contact list named in HubSpot and show how many records it returns.hubspot__read on crm/v3/lists/{listId}Yes, to read. Adding or removing members is outside the requested access. Not run in the test
Property definitionsShow the properties available on deals, with their types.hubspot__read on crm/v3/properties/dealsYes. Not run in the test
Create a contactCreate a contact with this name and email and associate it with this company.hubspot__writeYes, after you approve the call in Cursor. Not run, because it changes the portal
Edit a blog postUpdate the title of the blog post with this ID.hubspot__writeListed in the Ryze AI docs, not confirmed. The test read no real post, and HubSpot offers the content scope on CMS Hub or Marketing Hub Professional or Enterprise only
Remove a duplicateDelete the duplicate contact with this ID after showing me its details.hubspot__deleteYes, after approval. HubSpot keeps most deleted CRM records in its recycling bin for 90 days. Not run
Ticket queueList the open tickets for this company.hubspot__searchNo. The ticket search in the test came back not_allowed

9 ways to connect Cursor to HubSpot

Nine ways can bring HubSpot into Cursor, counting those whose vendor page names Cursor and the one HubSpot server that accepts any MCP client with OAuth and PKCE. They differ in where they run and in how much of HubSpot they reach: one reaches no CRM data at all, and two are built for reporting. The Ryze AI connector is the main way on this page, because HubSpot is approved once inside Ryze AI, Cursor holds one hosted address and no HubSpot token, and read, write and delete stay separate tools that Cursor can approve one by one. The other rows describe each vendor's pages as they read on November 14, 2026. None of them was set up for this guide.

WayRuns whereSetup in CursorWhat it reaches in HubSpotPrice
Ryze AI connector (the main way)Hosted by Ryze AI. One address for every userThe Add to Cursor link, or a url entry for https://connector.get-ryze.ai/mcp in mcp.json, then the browser sign-in. HubSpot is approved once in Ryze AIContacts, companies and deals to read, create, update and delete; owners and contact lists to read; CMS blog content. Several portals per workspace. No tickets or custom objectsPaid Ads is $89 per month with a 7-day free trial
HubSpot remote MCP serverHosted by HubSpot at https://mcp.hubspot.comCreate an MCP connector in HubSpot under Development, MCP Connectors, with a name, an optional description and a redirect URL, to get a client ID and secret. Then add https://mcp.hubspot.com to mcp.json with those static OAuth client credentials. HubSpot's page accepts any MCP client with OAuth and PKCE but does not name Cursor, and the redirect URL to use for Cursor was not checked36 documented tools for CRM records, tickets and custom objects included, activities, campaigns and content, within the user's own HubSpot permissions. The website page, blog post and render tools are limited to Claude, ChatGPT and Gemini. No delete toolNo price stated. Open to all HubSpot accounts since April 13, 2026. The AEO tools need Marketing Hub Professional or Enterprise
@hubspot/mcp-server (npm, beta)A Node process on your computerThe README gives a .cursor/mcp.json entry named hubspot that runs npx -y @hubspot/mcp-server with a private app token in PRIVATE_APP_ACCESS_TOKEN. New legacy private apps cannot be created since September 28, 2026 for new accounts and October 26, 2026 for older ones; existing ones keep working21 tools for objects, properties, associations, engagements, workflows and links, to read and write. No delete tool. 0.4.0 of June 18, 2025 is still the newest versionNo price stated. MIT license
HubSpot Agent CLI (beta)A hubspot program on your computer that the agent runs as commandsInstall it with HubSpot's install script, sign in with hubspot auth login in the browser, then add the skills with npx skills add hubspot/agent-cli-skills. The skills README names Cursor. HubSpot describes the Agent CLI as a command-line tool made for AI agentsContacts, companies, deals, tickets, custom objects, workflows, pipelines, properties and associations, within your own HubSpot user permissions, with a dry-run preview of each change. Some operations need a service key during the betaNo price stated. HubSpot's Developer Beta Terms apply
HubSpot Developer MCP serverOn your computer, as the server HubSpotDevInstall the HubSpot CLI with npm install -g @hubspot/cli, version 8.2.0 or higher, run hs mcp setup, select Cursor among the clients and restart Cursor23 tools for HubSpot's developer docs, projects, builds, test accounts and CMS templates, modules and functions. No CRM recordsNo price stated
ComposioHostedComposio's HubSpot page names Cursor, but its Cursor steps were not opened for this guide. Its hosted MCP address in the ChatGPT steps is https://connect.composio.dev/mcp, and Cursor takes a hosted address as a url entry in mcp.json. HubSpot is linked through Composio's managed OAuth app, your own OAuth app or an API key354 HubSpot tools and 2 triggers by Composio's count, including batch create, update and archiveFree plan: 10,000 tool calls a month, per the pricing page. Standard: $18 per seat per month
Zapier MCPHostedZapier's quickstart lists Cursor among its popular clients. Add Zapier MCP and sign in; Zapier creates a default server and turns on actions for the apps already linked to your Zapier accountThe HubSpot actions you turn on, such as Create Contact, Create Company and Create Associations. Zapier prints no totalNo separate MCP fee: 2 tasks per successful call, failed calls free. Free has 100 tasks a month; Professional starts at $19.99 per month billed annually
Windsor.aiHostedConnect HubSpot as a data source in Windsor.ai, then follow Windsor's setup guide for the Cursor desktop appReporting on 1,141 HubSpot fields: 287 metrics and 854 dimensions. Its MCP page names no HubSpot write actionIncluded on every plan; the free plan covers 1 data source. Basic is $23 per month billed monthly
Coupler.ioHostedLoad HubSpot through a Coupler.io data flow, then follow the MCP Server page inside Coupler.io, which uses a personal access token. Cursor is in its plan table of AI integrationsRead-only analysis of the loaded HubSpot datasets, passed to the AI as aggregates instead of single recordsA free plan; Starter is $32 per month. Its HubSpot page and its pricing page disagree on which plan includes MCP

Three HubSpot options that do not fit Cursor

  • HubSpot's connectors for ChatGPT, Claude, Gemini and Copilot. HubSpot's AI tools page names these four assistants for its live connectors, and each help article covers its own assistant only. Cursor is on none of them.
  • HubSpot plugins for Claude Code. The HubSpot/hubspot-mcp-plugins repository has install steps for Claude Code and the Claude desktop app, and its README does not name Cursor.
  • baryhuang/mcp-hubspot. The most starred result of a GitHub search for hubspot mcp (129 stars) runs in Docker with a HubSpot access token. Its README gives setup steps for the Claude desktop app only, through a docker entry or Smithery.

Which one to pick

Ryze AI is the best way to connect Cursor to HubSpot for CRM records and blog content from one hosted address, with several portals in one workspace and no HubSpot token in your files, with one caveat: tickets, custom objects and list editing are outside its access. For those jobs, and for the activity and revenue-object tools that the Ryze AI connector does not list, HubSpot's remote MCP server or the Agent CLI reach further. The cost is an MCP connector you create in HubSpot, or a program you install and keep signed in. When you build a HubSpot app or CMS theme in Cursor, add the Developer MCP server for docs and project tools; Cursor can run it next to the Ryze AI server. @hubspot/mcp-server suits a team that still has a private app token. Composio and Zapier make sense when other apps already run through them, and Windsor.ai and Coupler.io when the goal is reporting.

Sources: HubSpot remote MCP server, HubSpot remote MCP overview, @hubspot/mcp-server, HubSpot private app sunset, HubSpot Agent CLI, Agent CLI skills, HubSpot Developer MCP setup, HubSpot AI tools, HubSpot plugins for Claude Code, Composio HubSpot, Composio pricing, Zapier MCP quickstart, Zapier MCP usage, Zapier pricing, Windsor MCP, Windsor.ai pricing, Coupler.io HubSpot MCP, Coupler.io pricing, baryhuang/mcp-hubspot, Ryze AI HubSpot guide, checked November 14, 2026; Cursor MCP documentation, checked November 13, 2026.

HubSpot and MCP: dates that matter

DateWhat happened
April 25, 2025HubSpot first published @hubspot/mcp-server on npm.
May 6, 2025HubSpot announced that package as a public beta, run with a private app access token.
June 18, 2025@hubspot/mcp-server 0.4.0 came out. It was still the newest version on November 14, 2026.
September 1, 2025The remote HubSpot MCP server opened its first public beta.
January 13, 2026Self-service MCP Auth Apps for the remote server went into public beta. HubSpot's current docs call them MCP connectors.
February 19, 2026The HubSpot Developer MCP server, which lists Cursor among its clients, became generally available.
April 13, 2026The remote HubSpot MCP server became generally available to all HubSpot accounts, with write access and OAuth 2.1 with PKCE required.
September 15, 2026HubSpot's fall release gave the remote server custom objects, activable objects, Leads and read-only conversations, with quotes in public beta.
September 28, 2026New HubSpot accounts lost the option to create legacy private apps; older accounts followed on October 26, 2026. Service Keys are the replacement, and private apps made earlier keep working.
October 27, 2026@hubspot/cli 8.18.0, the CLI behind the Developer MCP server, came out. It was the newest release on November 14, 2026.
January 8, 2027The HubSpot developer CLI stops supporting Node.js 20 and will need Node.js 22 or higher, as HubSpot announced on October 19, 2026.

Sources: @hubspot/mcp-server versions, HubSpot changelog, May 6, 2025, HubSpot changelog on MCP Auth Apps, HubSpot changelog, Developer MCP server, HubSpot changelog, April 13, 2026, HubSpot Fall 2026 Spotlight, HubSpot private app sunset, @hubspot/cli versions, HubSpot changelog on Node.js 20. Checked November 14, 2026.

How this guide was tested

The connector was probed without a sign-in on November 13, 2026. A day later, on November 14, 2026, a signed-in MCP client sent it 11 HubSpot calls, all read-only: six searches, four reads and one list. The table sums up what came back.

What was runWhat came back
Request to the address with no sign-in (November 13)https://connector.get-ryze.ai/mcp returned HTTP 401 with a WWW-Authenticate header that points to the sign-in details. That header is where an OAuth client such as Cursor finds out how to sign in.
The discovery files (November 13)Both loaded. They list the authorize, token and register endpoints, the authorization code and refresh token grants, PKCE with S256, and the scopes mcp:read and mcp:write. The register endpoint is what lets Cursor sign up as a client without a secret.
HubSpot tool definitions (November 14)All five loaded by name. Each takes a workspace and an optional connection_id, and they match the tools table above.
Searches and one list (November 14)Contact, company and deal searches gave valid empty answers. Listing contacts with limit 1 returned one result and a paging cursor. No record content was kept.
Calls meant to fail (November 14)Seven: two searches with bad input, one ticket search and four reads of IDs that do not exist. Their exact messages are in the errors section below.

Not run: anything inside Cursor. Cursor was not used to add the server, finish the Ryze AI sign-in or call a tool, so the Cursor steps follow Cursor's MCP documentation as read on November 13, 2026. The HubSpot calls were sent from Claude Code, a different MCP client that reaches the same server and the same five tools. The portal was already connected in Ryze AI, so the HubSpot sign-in steps were not repeated for this guide. hubspot__write and hubspot__delete were not run, because they change the portal. No record was read by ID, and owners, lists, property definitions and blog posts were not listed. The over-limit request went to hubspot__search only, not to hubspot__listObjects.

Cursor and HubSpot errors and fixes

Exact error messages from the test

Five messages came back word for word in the calls of November 14, 2026. If one of them shows up in a Cursor tool result, the table gives the cause and the next thing to ask.

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 page holds 200 records at most.Ask Cursor for 200 or fewer per page and to continue with the after value.
There was a problem with the request.Error 400 for a search filter on a property HubSpot does not have. HubSpot does not say which property is wrong.Have Cursor read crm/v3/properties/contacts first and filter on 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.status not_allowed. The default Ryze AI connection could not search tickets on the test portal.Keep contacts, companies and deals on Ryze AI. For tickets in Cursor, use HubSpot's remote MCP server or the Agent CLI.
Object not found. objectId is usually positive.status not_found. No deal has the ID 0.Search for the record first and reuse the id from the result.
[hubspot] GET crm/v3/objects/contacts/{id}: provider returned text/html;charset=iso-8859-1 (status 404) "Error 404 Not Found"status not_found. HubSpot answered an invented contact or blog post ID with an HTML page, and the read tool, which parses only JSON, reports the 404. The ID is shown here as {id}, and the trace value at the end of the real message is left out.Check the ID. Look the contact up by email, or list blog posts and take an ID from that list.

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 be neither a Super Admin nor a holder of App Marketplace access, or the portal may lack a scope the app requires, which stops the install with an error. 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 search fails with 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.
Cursor reports too many requests
HubSpot allows 5 search requests per second per account, has a burst limit per 10 seconds, and answers 429 once an app goes past its limits. 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; for a contact search that set is firstname, lastname, email, lastmodifieddate, hs_object_id and createdate. Name the properties in the prompt, for example lifecycle stage or deal amount.
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 that lets an AI app call tools on an outside server. Cursor, Claude and ChatGPT support it, and the Ryze AI connector is such a server, hosted by Ryze AI.
mcp.json
Cursor's list of MCP servers, kept in your home folder for every project or in one project's .cursor folder.
Portal
A single HubSpot account. Every Ryze AI connection covers exactly one, and a workspace that holds several marks one with a star as the default.
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.
Scope
A named HubSpot permission, such as crm.objects.deals.read, that an app requests when it is installed. Each one opens a set of API endpoints and the data behind them.
MCP connector (in HubSpot)
What you create under Development, MCP Connectors to get a client ID and secret for HubSpot's own server at https://mcp.hubspot.com.

Sources: modelcontextprotocol.io for MCP; HubSpot scopes and HubSpot remote MCP server, checked November 14, 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's own servers come in three kinds: the remote server at https://mcp.hubspot.com, which accepts any MCP client with OAuth and PKCE without naming Cursor; the local Developer MCP server, which lists Cursor but has no CRM tools; and the older npm package @hubspot/mcp-server, whose README includes a Cursor setup.

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. HubSpot also ships a Developer MCP server for building apps and CMS assets, which does not read CRM records.

Can I use HubSpot's own remote MCP server in Cursor?

Probably, but this guide did not confirm it. HubSpot's documentation says any MCP client that supports OAuth with PKCE can use the server, and Cursor supports both, yet the page does not name Cursor. You first create an MCP connector in HubSpot under Development, MCP Connectors to get a client ID and secret, then give them to Cursor as static OAuth client credentials in mcp.json. This guide did not try that setup, and the redirect URL to enter for Cursor was not checked.

Does the HubSpot Developer MCP server give Cursor my CRM data?

No. The Developer MCP server lists Cursor as a supported client, but its 23 tools cover HubSpot's developer docs, projects, builds and CMS assets, with no tool for contacts, companies or deals. For CRM records in Cursor, use the Ryze AI connector, HubSpot's remote server or the HubSpot Agent CLI.

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.

Can Cursor read HubSpot tickets through Ryze AI?

No. A ticket search through the default Ryze AI connection was refused with status not_allowed on November 14, 2026, and tickets are not among the data the Ryze AI listing in the HubSpot Marketplace shares. HubSpot's remote MCP server and its Agent CLI both reach tickets.

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.

Connect HubSpot to Cursor

Your HubSpot account connects once in Ryze AI, then Cursor reads and edits CRM contacts, companies and deals. 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 help center page for HubSpot or email Ryze AI support.