By Ira Bodnar, Ryze AI · Updated · Connector tested November 13, 2026
Quick answer
The main way to connect Claude to HubSpot is the Ryze AI connector. Approve HubSpot once inside a Ryze AI workspace with HubSpot's own sign-in, then paste https://connector.get-ryze.ai/mcp into Claude as a custom connector under Customize, Connectors, allow that workspace and open a new chat.
- In Ryze AI open Integrations, find HubSpot and click Connect
- Sign in to HubSpot, choose the account and approve the permissions
- In Claude open Customize, Connectors, then Add and Add custom connector, and paste the URL
- Click Connect if Claude shows it, pick the workspace, click Allow connection, open a new chat
Claude to HubSpot at a glance
| Fact | Detail |
|---|---|
| Main way to connect | The Ryze AI connector. Claude takes it as a custom connector by its address, or from the Ryze AI listing in Claude's Connectors Directory |
| Connector address | https://connector.get-ryze.ai/mcp, identical for every account |
| How you sign in | Two OAuth screens in the browser: HubSpot's, started inside Ryze AI, and then the Ryze AI screen, started from Claude. Claude needs only a name and the address, with no key or client ID |
| HubSpot tools | 5 in total. hubspot__read, hubspot__search and hubspot__listObjects fetch data, hubspot__write creates and updates, hubspot__delete archives |
| Changes to HubSpot | Possible through the write and delete tools. Put both on Needs approval under Tool permissions if Claude should ask before each change |
| Claude plan | Any plan. Free allows one custom connector, which is enough. On Team and Enterprise an Owner adds it for the organization first |
| Where it works after setup | claude.ai, Claude Desktop and the mobile apps through your Claude account, and Claude Code when it is signed in with that same account |
| HubSpot user who can connect | A Super Admin, or a user who holds App Marketplace Access |
| Ryze AI price | Paid Ads at $89 per month with a 7-day free trial. Adding the connector costs nothing |
| HubSpot's own option for Claude | The HubSpot connector for Claude, on paid Claude plans. It covers more object types, including tickets, and has no delete |
| Last tested | Connector sign-in details on November 13, 2026 and 11 read-only HubSpot calls on November 14, 2026. No step was run inside Claude |
Before you start
- A Claude account on any plan. Anthropic offers custom connectors on Free, Pro, Max, Ultra, Team and Enterprise, and a Free account holds one of them. On Team, Owners and Primary Owners add the connector for the organization in Organization settings, Connectors. On Enterprise, people whose custom role includes Manage access to Libraries can add it too. Each member then clicks Connect.
- Super Admin or App Marketplace Access in HubSpot. HubSpot only lets users with one of these permissions install apps. Anyone else has to ask a Super Admin to connect. If the portal's plan lacks a scope the app requires, HubSpot shows an error during install.
- A Ryze AI workspace on a plan or free trial. Paid Ads is $89 per month with a 7-day free trial; Agency ($279 per month) and the SEO plans also include the connector. Without a plan Claude can list your workspaces and connect platforms, but every other Ryze AI tool replies that a subscription is required.
How to connect Claude to HubSpot in claude.ai
Three steps happen in Ryze AI and HubSpot, three in Claude. 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.
Sign in to HubSpot and choose the account
Sign in to the HubSpot account you want Claude to work with. If your login has access to more than one HubSpot account (portal), pick the one you want and click Choose Account.

Approve the permissions
HubSpot lists the access Ryze AI requests. Review it and approve. HubSpot sends you back to Ryze AI, the HubSpot card shows Connected, and View on the card shows the linked account by its HubSpot domain.

Add the custom connector in Claude
In claude.ai open Customize, then Connectors; in Claude Desktop, Customize sits in the sidebar. Click Add (some of Anthropic's pages print it as + Add) and choose Add custom connector, or Custom and then Web. Name it Ryze AI and paste https://connector.get-ryze.ai/mcp into the MCP server URL field, with /mcp at the end. Keep the sign-in options Claude marks Detected, never pick No sign in, click Continue if the dialog shows it, then Add. There is no client ID, secret or key to enter for Ryze AI.
Click Connect and allow the workspace
If the connector shows Connect, click it. On claude.ai the Ryze AI page opens in the same tab; from Claude Desktop it opens in your browser. On the page Connect your data sources to AI, sign in if asked, choose the workspace that holds your HubSpot connection under Workspaces and click Allow connection. One connection can cover up to 20 workspaces.
Open a new chat and ask your first question
Start a new chat, as the Ryze AI help center advises, and check under the + button, Connectors, that Ryze AI is switched on for it. Ask: List the HubSpot deals created in the last 30 days with amount, stage and Original Traffic Source.
The Ryze AI help article for HubSpot covers the HubSpot side of the connection, and the Claude connector FAQ covers the connection errors.
Sources: Anthropic: custom connectors using remote MCP, Claude docs: add a connector that is not listed, Claude docs: getting started with connectors, Ryze AI HubSpot guide. Checked November 14, 2026.
Claude Desktop and connector facts
Connectors you add on claude.ai are saved to your Claude account, so Claude Desktop lists the same Ryze AI connector, and the mobile apps pick it up after your next sign-in there. To add it from the desktop app instead, select Customize in the sidebar, then Connectors, and repeat steps 4 to 6. Either way Claude reaches the connector from Anthropic's cloud, not from your computer.
The local config file
Claude Desktop also reads a local file, claude_desktop_config.json, that starts servers as commands on your own machine. The Ryze AI connector is hosted, so it needs no entry there; the two local HubSpot servers in the ways table below are the ones that go in this file. The Ryze AI developers page still lists a config-file entry for readers who want one, which needs Node.
Anthropic keeps this file apart from connectors. A server listed there runs on your machine and uses your local network, it does not show up on claude.ai or in Cowork sessions that run in the cloud, and Research cannot call its tools. So Customize, Connectors stays the route for this guide. To open the file, choose Settings, Developer, Edit Config in the desktop app. The Model Context Protocol project gives its location as ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows and ~/.config/Claude/claude_desktop_config.json on Linux. Quit Claude Desktop completely and start it again after saving.
Claude connectors: the facts in one table
| Question | What Anthropic's pages say |
|---|---|
| Where does the address go? | Customize > Connectors, then Add and Add custom connector. Anthropic's help center also prints the path as + Add, or as Custom and then Web |
| Who adds it on Team and Enterprise? | Owners and Primary Owners, starting in Organization settings > Connectors. On Enterprise, a custom role with Manage access to Libraries may add it as well. Every member then connects with their own sign-in |
| Which fields does the dialog show? | A name, the MCP server URL, Authentication, OAuth client and, under Advanced, Transport. Request headers appear only for organizations in that beta. The layout differs from one organization to the next |
| Which transports work? | Streamable HTTP for a remote server. The legacy HTTP+SSE transport is still accepted while it is being deprecated. Desktop extensions run over stdio |
| How does the sign-in start? | With an HTTP 401 answer to a request that carries no credentials. Claude then runs OAuth with a PKCE S256 challenge on every authorization request and returns to https://claude.ai/api/mcp/auth_callback |
| How does Claude identify itself to the server? | With Claude's published identity, by registering automatically through Dynamic Client Registration, or with an OAuth client you enter. The Ryze AI sign-in details name a register endpoint (November 13 test); which option Claude marks Detected for Ryze AI was not checked |
| Where do the calls come from? | Anthropic's cloud, on every Claude app including Desktop and mobile. The server must answer over HTTPS on port 443, on a host with public IPv4 addresses |
| How are tool calls approved? | A prompt offers Allow once or Always allow. Standing rules live under the connector's Tool permissions as Always allow, Needs approval or Blocked, per group of tools or per tool |
| What changes during Research? | Claude may call connector tools without asking again, so Anthropic suggests switching write tools off first. Research cannot reach local servers, and Research started on a phone leaves connectors out |
| Where is it managed afterwards? | Customize > Connectors, then the connector under Your connectors: Tool permissions, Disconnect, or Remove in the three-dot menu. Its status reads Connected, Connect or Reconnect |
| Which connector errors are documented? | Couldn't reach the MCP server; Authorization with the MCP server failed; and Unexpected error while invoking tool, followed by the tool name. A failed connection or sign-in on claude.ai carries a reference ID that starts with ofid_ |
| How is Ryze AI listed in the directory? | With the Community label, sign-in marked Required, the address above and Added August 2026, read signed out on November 14, 2026. Anthropic does not verify Community connectors |
Sources: Anthropic: custom connectors using remote MCP, Anthropic: use connectors, Claude docs: add a connector, Claude docs: authentication, Claude docs: building connectors, Claude docs: troubleshooting, Anthropic: Research, Ryze AI listing in the Connectors Directory, Model Context Protocol: local servers. Checked November 14, 2026.
Claude Code
Claude Code adds MCP servers from the command line. One command registers the connector:
claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp --scope userThen open Claude Code, type /mcp, pick the Ryze AI server (ryze) and finish the sign-in in the browser tab that opens. The user scope makes the server available in all your projects; use --scope project to share it with your team through a .mcp.json file in the repository. Run claude mcp list to see whether the server shows as connected.
If Claude Code is signed in with the same Claude account you used on claude.ai, the connector you added there is already available, so the command is optional. Claude Code needs a Pro, Max, Ultra, Team, Enterprise or Console account; the Free plan does not include it. The Claude Code guide for HubSpot covers it step by step.
Claude Code is useful when the HubSpot pull feeds other work, for example writing a weekly file that joins ad spend from Google Ads with new HubSpot deals. For scripts and your own agents, Ryze AI also offers API keys (Workspace Settings, Profile, API keys) sent as a Bearer token.
ChatGPT, Cursor and Windsurf
The same URL works in other MCP clients. HubSpot is connected once in Ryze AI, so nothing changes on the HubSpot side.
ChatGPT
On ChatGPT web open Plugins, select the plus button, then Add custom MCP server, enter the same URL and choose OAuth. OpenAI gives full MCP to Business and Enterprise/Edu workspaces and read and fetch permissions to Pro; its help article does not mention Free, Go or Plus. If you connect HubSpot in Ryze AI after adding the server, the Ryze AI help center says to remove the app, install it again and start a new chat. The ChatGPT guide for HubSpot has every step.
Cursor and Windsurf
Cursor reads the server from .cursor/mcp.json in a project, or ~/.cursor/mcp.json for every project, with the entry below. Windsurf's MCP documentation now redirects to Devin Desktop, which takes the same url entry in ~/.config/devin/mcp_config.json.
{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }HubSpot permissions and scopes
The HubSpot side of the connection is a standard HubSpot OAuth app install. Three things decide what Claude can see.
- Who can connect
- A HubSpot Super Admin or a user with App Marketplace Access; anyone else needs a Super Admin to do the install. A portal whose plan cannot grant one of the app's required scopes stops the install with an error.
- Which account
- One connection is one HubSpot account (portal). If your login sees several, HubSpot asks you to choose one. You can add more portals to the same Ryze AI workspace later with Add one more account.
- What the token covers
- HubSpot notes that an access token carries the scopes the app requested, and the installing user's own record limits do not apply. A user who can only view their own contacts but grants a contacts read scope gives the app a token that can read all contacts. Connect with a login whose reach you are comfortable sharing.
Scopes behind each action
Ryze AI's help center lists what the agent can do once HubSpot is connected. The table maps each action to the HubSpot scope name from HubSpot's scope reference, so you can match it against the consent screen. The consent screen itself is the source of truth for the exact list.
| Action in Ryze AI | HubSpot scope |
|---|---|
| Read and edit contacts | crm.objects.contacts.read, crm.objects.contacts.write |
| Read and edit companies | crm.objects.companies.read, crm.objects.companies.write |
| Read and edit deals | crm.objects.deals.read, crm.objects.deals.write |
| Read contact lists | crm.lists.read |
| Look up record owners | crm.objects.owners.read |
| Read and edit CMS blog content | content (HubSpot lists it for CMS Hub Professional or Enterprise, or Marketing Hub Professional or Enterprise) |
Every scope of the Ryze AI connection, and what is left out
Ryze AI describes its HubSpot access in plain words: eight parts it needs, plus optional ones such as files, CMS functions, knowledge base and membership. The table pairs each part with the matching entry in HubSpot's scope reference and the HubSpot accounts that can grant it. On the HubSpot Marketplace, the Ryze AI listing shares eight kinds of data: contacts and their properties, companies, deals and their properties, contact lists, owners, and CMS blog posts.
| Part of the connection | Matching scope entry | What HubSpot says it opens | Accounts that can grant it |
|---|---|---|---|
| Contacts, read and write (required) | crm.objects.contacts.read, crm.objects.contacts.write | Seeing contact details, and creating, changing or deleting contacts | Every HubSpot account |
| Companies, read and write (required) | crm.objects.companies.read, crm.objects.companies.write | Seeing company details, and creating, changing or deleting companies | Every HubSpot account |
| Deals, read and write (required) | crm.objects.deals.read, crm.objects.deals.write | Seeing deal details, and creating, changing or deleting deals | Every HubSpot account |
| Owners, read (required) | crm.objects.owners.read | The users assigned to a CRM record | Every HubSpot account |
| Contact property settings, read (required) | crm.schemas.contacts.read | How the contact properties are set up | Every HubSpot account |
| Deal property settings, read and write (required) | crm.schemas.deals.read, crm.schemas.deals.write | Seeing and changing how the deal properties are set up | Every HubSpot account |
| Contact lists, read (required) | crm.lists.read | The details of contact lists | Every HubSpot account |
| Content (required) | content | HubSpot's content APIs, blogs and website and landing pages among them | CMS Hub or Marketing Hub, Professional or Enterprise |
| Files (optional) | files | The file manager, through a legacy scope that HubSpot recommends existing apps replace with granular ones | Every HubSpot account |
| CMS functions (optional) | cms.functions.read, cms.functions.write | Content Hub serverless functions and their secrets | Content Hub Enterprise |
| Knowledge base (optional) | cms.knowledge_base.articles.read and its related entries | Knowledge articles, read through the GraphQL API | Service Hub Professional or Enterprise |
| Membership (optional) | cms.membership.access_groups.read, cms.membership.access_groups.write | Membership access groups | Service Hub or Content Hub, Professional or Enterprise |
HubSpot treats the two groups differently at install time. When the chosen account cannot grant a required scope, the install stops with an error. An optional scope the account has no access to is dropped from the request automatically. Whether a portal without CMS Hub or Marketing Hub Professional can finish the Ryze AI install was not tested for this guide.
Outside the list: tickets, custom objects, list editing (crm.lists.write), company property settings (crm.schemas.companies.read) and HubSpot's Sensitive Data scopes. In the November 14, 2026 test a ticket search through Ryze AI was refused. When Claude has to work on tickets or custom objects, HubSpot's own connector for Claude reads and edits both.
Sources: HubSpot scope reference, HubSpot: working with OAuth, HubSpot: install apps from the Marketplace, Ryze AI listing in the HubSpot Marketplace, Ryze AI HubSpot guide. Checked November 14, 2026.
Removing access
To remove access, uninstall the app in HubSpot under Settings, Integrations, Connected Apps, Actions, Uninstall, and type uninstall to confirm. In Ryze AI, click View on the HubSpot card and use the trash icon to disconnect a portal. In Claude, open Customize, Connectors, Ryze AI and click Disconnect, which signs Claude out and keeps the connector in your list, or choose Remove in the three-dot menu to take it off your account.
What Claude can do in HubSpot
The Ryze AI connector exposes five HubSpot tools: three that read, one that writes and one that deletes. Each takes a workspace and an optional connection_id for a second portal, and runs as the HubSpot account you connected.
| Tool | Type | What it does |
|---|---|---|
| hubspot__read | Read | Sends a GET request to a HubSpot JSON resource by its path: one record, property definitions, owners, a list or blog posts. |
| hubspot__search | Read | Runs the HubSpot CRM Search API on contacts, companies or deals. Filter groups are joined with OR, filters inside a group with AND, up to 200 results per page. |
| hubspot__listObjects | Read | Lists the records of one object type, up to 100 per page, with the properties you name and the IDs of associated records. |
| hubspot__write | Write | Creates or updates contacts, companies, deals and blog posts, and adds associations between records. Its two methods are CREATE and UPDATE. |
| hubspot__delete | Delete | Archives a record or blog post by ID. Most CRM deletes go to HubSpot's recycling bin; deleted blog posts may not be recoverable. |
Decide how Claude may change HubSpot before the first edit. In Customize, Connectors, Ryze AI, Tool permissions, leave the three read tools on Always allow and set hubspot__write and hubspot__delete to Needs approval, or to Blocked if Claude should never change the portal. When Claude asks, Allow once covers that single call. During Research Claude can call connector tools without asking, so switch the write tools off before you start one. The Ryze AI chat has its own Tool approvals setting, which starts on Skip all approvals; pick Approve write & delete or Manual approve there. Scheduled tasks in Ryze AI run without an approval step.
Limits in numbers
| Limit | Number | Set by |
|---|---|---|
| Results per search page | 10 when you name no limit, 200 at most. A request for 201 was refused in the test | HubSpot |
| Results per search query | 10,000. Paging past that point returns a 400 error | HubSpot |
| Filters in one search | 5 filter groups of up to 6 filters each, and 18 filters in all | HubSpot |
| Operators in hubspot__search | 12, among them EQ, BETWEEN, IN, HAS_PROPERTY and CONTAINS_TOKEN | Ryze AI tool definition |
| Search calls per second | 5 for each HubSpot account. Search responses carry no rate limit headers | HubSpot |
| Size of one search request | 3,000 characters. A longer request body returns a 400 error | HubSpot |
| Records per list page | 100: the cap of hubspot__listObjects, and the most contacts HubSpot returns in one request | Ryze AI tool definition and HubSpot |
| Path length for read, write and delete | 2,048 characters | Ryze AI tool definitions |
| Requests every 10 seconds | 110 for each account that installs an OAuth app distributed through the HubSpot Marketplace, searches not counted, then a 429 error. Ryze AI signs in through OAuth and has a Marketplace listing, but HubSpot's page does not name it and no response in the test carried a rate limit header | HubSpot |
| Recycling bin | Deleted CRM records can be restored for 90 days | HubSpot |
| Size of one tool result | About 150,000 characters | Anthropic, for claude.ai and Claude Desktop |
| Length of one tool call | 240 seconds | Anthropic, for claude.ai and Claude Desktop |
Sources: HubSpot CRM search guide, HubSpot API usage guidelines, HubSpot contacts API guide, HubSpot: restore deleted records, HubSpot connector for Claude, Claude docs: building connectors. Checked November 14, 2026.
What the default connection returned, tested
On November 14, 2026, 11 calls went from Claude Code through the Ryze AI connector to a HubSpot portal already linked with the default HubSpot connection. The searches used values that could match nothing, the IDs were invented, and the one listed contact is described by its field names only, so no record of that portal appears here.
| What was asked | Tool and input | Answer |
|---|---|---|
| Contacts by email | hubspot__search, email equal to a random string of 20 letters | Worked, with the empty result {"total":0,"results":[]} |
| Companies by domain | hubspot__search, domain equal to 20 random letters | Worked, with the same empty shape |
| Deals by deal name | hubspot__search, dealname equal to 20 random letters | Worked, with the same empty shape |
| One contact from the list | hubspot__listObjects, limit 1, only the property hs_object_id | Worked. The result held id, properties, createdAt, updatedAt, archived and url, plus paging.next with after and link. HubSpot added createdate and lastmodifieddate on its own |
| Contacts by a property that does not exist | hubspot__search with a filter on a made-up property name | Refused with Error 400 |
| 201 contacts in one page | hubspot__search with limit 201 and a filter that could not match | Refused with Error 400, category VALIDATION_ERROR |
| Tickets | hubspot__search on tickets with a filter that could not match | Refused with the status not_allowed |
| The deal with ID 0 | hubspot__read of crm/v3/objects/deals/0 | The status not_found |
| A contact with an invented ID | hubspot__read of a contact path with an 18-digit ID | The status not_found, after HubSpot sent an HTML 404 page |
| A blog post with an invented ID | hubspot__read of cms/v3/blogs/posts/ with an 18-digit ID | The status not_found, with the same HTML 404 page |
| The blog post with ID 1 | hubspot__read of cms/v3/blogs/posts/1 | The status not_found again. Neither blog read shows whether blog reads work on that portal |
First 3 prompts to run
The prompts below rely on traffic source properties that HubSpot sets automatically on contacts. Original Traffic Source is the first known source, with values such as Paid search, Paid social, Organic search and Direct traffic. For Paid search, drill-down 1 holds the utm_campaign value. For Paid social, drill-down 1 holds the social site and drill-down 2 holds the utm_campaign value. Companies and deals associated with a contact mirror these properties.
1. Deals by original source
List the HubSpot deals created in the last 30 days with deal name, amount, stage and Original Traffic Source. Group them by source and total the amount for each source.
Tools used: hubspot__search on deals
What comes back: A table of deals grouped by source with a count and total amount per source, plus any deals that have no source value.
2. Google Ads spend against new HubSpot contacts
Pull Google Ads spend by campaign for the last 30 days. Then find HubSpot contacts created in the same period whose Original Traffic Source is Paid search, match Original Traffic Source drill-down 1 to the campaign names, and show spend, new contacts and spend per new contact for each campaign.
Tools used: A Google Ads query, hubspot__search on contacts
What comes back: One row per Google Ads campaign with spend, matched contacts and spend per contact, and a separate list of campaigns and drill-down values that did not match by name.
3. Meta Ads campaigns to deals
Pull Meta Ads spend by campaign for the last 30 days. Find HubSpot contacts with Original Traffic Source Paid social whose drill-down 2 matches a campaign name, then list the deals associated with those contacts with amount and stage.
Tools used: Meta Ads insights, hubspot__search, and hubspot__listObjects with associations
What comes back: For each Meta campaign: spend, matched contacts, associated deals with amount and stage, and the total open and won deal amount.
Each answer comes from your own accounts, so this page describes what comes back instead of showing sample numbers. The Google Ads and Meta Ads parts need those platforms connected in the same Ryze AI workspace.
10 jobs to hand to Claude
Ten jobs you can hand to Claude, each with the HubSpot tool it calls. In the November 14, 2026 test the search tool and the list tool ran with inputs that matched nothing or a single record. Reads of owners and property definitions, and every write and delete, were not run.
| Job | What to ask Claude | Tool | On the default connection |
|---|---|---|---|
| Contact lookup | Look up the HubSpot contact with the email I paste and give me their lifecycle stage, owner and create date. | hubspot__search | Yes |
| Deals from the last 30 days | Which deals were created in HubSpot in the last 30 days? Give the name, amount and stage of each. | hubspot__search | Yes |
| Deals that went quiet | Find open deals nobody has changed in 30 days and tell me who owns each one. | hubspot__search, then hubspot__read on crm/v3/owners | Yes. The owners read was not part of the test |
| Account map | Find the company on this domain and show every contact and deal linked to it. | hubspot__search, then hubspot__listObjects with associations | Yes. The test did not ask for associations |
| Contacts in pages | Walk through all contacts, 100 per page, with lifecycle stage and create date. | hubspot__listObjects | Yes |
| Property names before a filter | Give me the internal names of my deal properties so we can build a search. | hubspot__read on crm/v3/properties/deals | Yes. Not run in the test |
| New deal with links | Create a deal for this company, attach its main contact, and show me the new record. | hubspot__write | Yes. Not run, because it changes the portal |
| Property change | Set this contact's lifecycle stage to the value I give you, then read the contact back. | hubspot__write with UPDATE, then hubspot__read | Yes. Not run |
| Duplicate removal | Delete the contact with this ID. | hubspot__delete | Yes. Most CRM deletes can be restored from the recycling bin for 90 days. Not run |
| Ticket review | Show the open tickets for this company. | hubspot__search | No. A ticket search came back not_allowed in the test |
11 ways to connect Claude to HubSpot
This guide counts 11 ways for Claude to reach a HubSpot account. A hosted server works everywhere Claude runs, because Claude calls it from Anthropic's cloud; a server started by a command works in the Claude desktop app alone. This guide treats the first row, the Ryze AI connector, as the main way: HubSpot is approved once in Ryze AI, Claude gets one pasted address, and reading, writing and deleting stay in separate tools. The other rows describe each vendor's own pages as they read on November 14, 2026. None of them was set up for this guide.
| Way | Runs where | Setup in Claude | What it reaches in HubSpot | Price |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Hosted by Ryze AI. One address for everyone | Customize, Connectors, Add custom connector with https://connector.get-ryze.ai/mcp, or Ryze AI from its Community listing in the Connectors Directory. HubSpot itself is approved once inside Ryze AI | Contacts, companies and deals to read, create, update and delete; contact lists and owners to read; CMS blog content. Several portals per workspace. No tickets or custom objects | Paid Ads at $89 per month with a 7-day free trial. Fits every Claude plan, Free included |
| HubSpot connector for Claude | Hosted by HubSpot. Claude on web, desktop and mobile | HubSpot's article: Settings, Connectors, Browse, HubSpot, Connect, then log in to HubSpot and choose the permissions (Anthropic's pages now put connectors under Customize). In a chat, + then Connectors switches it on. Users without Super Admin or App Marketplace Access wait for a Super Admin to approve it | Contacts, leads, companies, deals, tickets, custom objects, pipelines, products, line items, website and landing pages, blog posts, segments and activities to read, create and update. Campaigns and properties to read and create; invoices, orders, payments and saved reports to read. No delete, 10 records per bulk request, one HubSpot account per Claude account | No HubSpot price. Needs a paid Anthropic plan: Pro, Max, Team or Enterprise |
| HubSpot remote MCP server | Hosted by HubSpot at https://mcp.hubspot.com | Create an MCP connector in HubSpot under Development, MCP Connectors, with https://claude.ai/api/mcp/auth_callback as its redirect URL. Add https://mcp.hubspot.com in Claude as a custom connector, choose Use your own OAuth client and enter the client ID and secret. HubSpot's overview sends Claude users to its ready-made connector instead | 36 documented tools for CRM records, activities, campaigns, pages and blog posts, within the user's own HubSpot permissions. Claude is one of the three clients that get the website page, blog post and render tools. No delete tool | No price stated. Open to all HubSpot accounts since April 13, 2026 |
| HubSpot plugins for Claude (GitHub) | A plugin in the Claude desktop app. Its tools run on HubSpot's remote MCP server | HubSpot's README: in the desktop app open Settings, Plugins, Add, Add marketplace, paste https://github.com/HubSpot/hubspot-mcp-plugins and pick a plugin. Anthropic notes that adding a plugin does not connect its connectors: each one is connected from the plugin's Connectors tab | Two plugins: HubSpot Sales for contacts, deals and onboarding, and HubSpot Partner for Solutions Partner client records. The README names no tools | No price stated. Apache-2.0 license |
| HubSpot Agent CLI (beta) | A program on your computer that an agent runs | Install the hubspot program with HubSpot's install script, sign in with hubspot auth login, then add the skills with npx skills add hubspot/agent-cli-skills. HubSpot's pages name Claude Cowork and coding agents in the Claude app | CRM records under your own user permissions: contacts, companies, deals, tickets, custom objects, pipelines and properties. Every change can be previewed before it takes effect. Some operations need a service key during the beta | No price stated. Beta, under HubSpot's Developer Beta Terms |
| Composio | Hosted | Composio's HubSpot page names Claude. Its MCP address, https://connect.composio.dev/mcp, is a remote server, so it goes into Claude as a custom connector; Composio's own Claude steps were not opened for this guide. HubSpot is connected through Composio's managed OAuth app | 354 HubSpot tools and 2 triggers by Composio's count, batch create, update and archive included | Free with 10,000 tool calls a month, per the pricing page. Standard is $18 per seat per month |
| Zapier MCP | Hosted | Add Zapier as a connector in Claude and sign in. Zapier creates a default server and switches on actions for apps already linked to your Zapier account. Its quickstart lists Claude among the popular clients | The HubSpot actions you turn on in Zapier. Zapier prints no total | 2 Zapier tasks per successful call, failed calls free. Free has 100 tasks a month; Professional starts at $19.99 per month billed annually for 750 |
| Windsor.ai | Hosted | Connect HubSpot as a data source in Windsor.ai, then add Windsor MCP from Claude's Connectors menu | Reporting access to 1,141 HubSpot fields: 287 metrics and 854 dimensions. Its MCP page names no HubSpot write action | Included on every plan. The free plan covers 1 data source; Basic is $23 per month billed monthly |
| Coupler.io | Hosted | Load HubSpot with a Coupler.io data flow, then follow the MCP Server page inside Coupler.io, which works with a personal access token. Its plan table lists Claude among the AI integrations | Read-only analysis of the loaded datasets, handed to the AI as aggregates rather than single records | A free plan, and Starter at $32 per month. Its two pages disagree on which plan includes the MCP server |
| @hubspot/mcp-server (npm, beta) | On your computer, in Claude Desktop only | A command entry in claude_desktop_config.json that runs npx -y @hubspot/mcp-server with a private app access token. HubSpot stopped the creation of new legacy private apps on September 28, 2026 for new accounts and on October 26, 2026 for older ones; existing private apps keep working | 21 tools for objects, properties, associations, engagements and workflows, read and write, with no delete. Version 0.4.0 of June 18, 2025 is still the latest | No price stated. MIT license |
| baryhuang/mcp-hubspot (open source) | A Docker container on your computer, in Claude Desktop only | A docker command entry in claude_desktop_config.json with a HubSpot access token, or the Smithery install for the Claude client given in the README | 7 tools for contacts, companies, company activity and recent conversations. No deal tools | Free, MIT license. 129 GitHub stars, last push November 11, 2025 |
HubSpot options that do not fit Claude
- HubSpot Developer MCP server. A local server installed with the HubSpot CLI for building apps and CMS assets; none of its 23 tools touches CRM records. Its setup page lists Claude Code, Codex CLI, Cursor, Gemini CLI, VS Code and Windsurf. The Claude app is not among them.
- HubSpot's connectors for other assistants. The connector for ChatGPT names ChatGPT only. The read-only connector for Gemini names Gemini and needs a paid Google Workspace plan. The HubSpot Agent runs in Microsoft 365 Copilot. None of those three pages lists Claude as an assistant it works in.
Which one to pick
Ryze AI is the best way to connect Claude to HubSpot when one Claude connection should cover several portals and the ad platforms of the same workspace, and deletes should sit in a tool of their own, with one caveat: tickets, custom objects and list editing are outside its access, so those jobs need HubSpot's own connector. That connector is the simpler pick when the work stays inside HubSpot and you pay for Claude: it covers more HubSpot objects and needs no Ryze AI account. The remote MCP server suits a team building its own agent, and the Agent CLI suits agents that run commands. Composio and Zapier fit teams that already run other apps through them, Windsor.ai and Coupler.io fit reporting, and the two local servers suit someone who wants the server on their own machine in Claude Desktop.
Sources: HubSpot connector for Claude, HubSpot remote MCP server, HubSpot remote MCP overview, HubSpot/hubspot-mcp-plugins, Claude docs: plugins, HubSpot Agent CLI, Agent CLI developer guide, Composio HubSpot toolkit, Composio pricing, Zapier MCP quickstart, Zapier MCP usage, Zapier pricing, Windsor MCP, Windsor.ai pricing, Coupler.io HubSpot MCP, Coupler.io pricing, HubSpot MCP server beta, @hubspot/mcp-server on npm, HubSpot private app sunset, baryhuang/mcp-hubspot, HubSpot Developer MCP setup, HubSpot connector for ChatGPT, HubSpot connector for Gemini, HubSpot Agent for Copilot, Ryze AI HubSpot guide. Checked November 14, 2026.
Claude, HubSpot and MCP: dates that matter
| Date | What happened |
|---|---|
| November 25, 2024 | Anthropic open-sourced the Model Context Protocol, with local MCP servers in the Claude Desktop apps on every plan. |
| May 1, 2025 | Claude gained remote MCP servers on the web and in the desktop app, in beta on Max, Team and Enterprise, under the name Integrations. Pro followed on June 3, 2025. |
| May 6, 2025 | HubSpot put its npm MCP server, @hubspot/mcp-server, into public beta. |
| July 14, 2025 | Anthropic opened its directory of connectors on web and desktop. |
| July 29, 2025 | HubSpot first published its help article for the HubSpot connector for Claude. |
| September 1, 2025 | HubSpot's remote MCP server went into its first public beta. |
| February 25, 2026 | Claude Desktop gained a Customize section that holds skills, plugins and connectors. |
| April 13, 2026 | HubSpot's remote MCP server became generally available to all HubSpot accounts, with write access and OAuth 2.1 with PKCE. |
| August 2026 | The Ryze AI listing joined Claude's Connectors Directory, going by the Added date on the listing. |
| September 15, 2026 | HubSpot's Claude connector and remote MCP server gained custom objects, activable objects and Leads, quotes in public beta and read-only conversations. |
| October 26, 2026 | Older HubSpot accounts lost the option to create new legacy private apps, four weeks after new accounts. Service Keys are HubSpot's replacement. |
| October 30, 2026 | HubSpot's Sensitive Data access for AI connectors went into public beta. With a Super Admin's consent, the Claude connector can read Sensitive Data properties and engagements. |
| November 10, 2026 | Anthropic began letting connected tools open beside the chat or full screen, rolling out on web and desktop. |
| November 12, 2026 | HubSpot last updated its help article for the Claude connector. |
Sources: Anthropic: Model Context Protocol, Anthropic: Integrations, Anthropic: connectors directory, Claude release notes, Anthropic: tools beside the chat, HubSpot MCP server beta, HubSpot remote MCP beta, HubSpot remote MCP general availability, HubSpot Fall 2026 Spotlight, HubSpot private app sunset, HubSpot October 2026 rollup, HubSpot connector for Claude, Ryze AI listing in the Connectors Directory. Checked November 14, 2026.
How this guide was tested
Two runs stand behind this guide. On November 13, 2026 the connector's address and sign-in details were checked from outside. On November 14, 2026, 11 read-only HubSpot calls went through the connector: 6 to hubspot__search, 4 to hubspot__read and 1 to hubspot__listObjects.
| Check | Result |
|---|---|
| Address without a sign-in (November 13) | https://connector.get-ryze.ai/mcp answered HTTP 401 with a WWW-Authenticate header that points to its sign-in details. Anthropic's pages name the 401 as what makes Claude begin a sign-in. |
| Sign-in details (November 13) | Both discovery files on the connector's host loaded. They name the authorize, token and register endpoints, the authorization code and refresh token grants, PKCE with S256, and two scopes: mcp:read and mcp:write. S256 is the method Claude sends on every authorization request. |
| HubSpot tool definitions (November 14) | All 5 loaded by name and match the tools table on this page. |
| Searches and a list (November 14) | Searches on contacts, companies and deals came back as valid empty results. Listing contacts with limit 1 returned one result and a paging cursor. |
| Calls that were refused or found nothing (November 14) | 7 in all: 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. |
Not run for this guide: any step inside Claude. No connector was added on claude.ai or in Claude Desktop, no Ryze AI sign-in was finished there, and no tool was called from a Claude chat, so the Claude steps follow Anthropic's pages as they read on November 14, 2026. Which OAuth client option Claude marks Detected for the Ryze AI server was not checked either. The HubSpot calls were sent from Claude Code, a separate Claude app that 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.
HubSpot errors and fixes
Exact error messages from the test
These messages came back in the November 14, 2026 test, word for word except for the IDs and trace values left out here. If Claude reports one of them after a HubSpot call, the table gives the cause and what to ask Claude next.
| Message | What it means | What to do |
|---|---|---|
| limit must be in range [0..200] (actual value: 201) | HubSpot's validation error, Error 400 with the category VALIDATION_ERROR: one CRM search page holds 200 records at most. | Ask Claude for pages of 200 or fewer and to carry on from the after value. |
| There was a problem with the request. | Error 400 for a search that filtered on a property name HubSpot does not know. The message does not say which name. | Have Claude read the property definitions first, for example crm/v3/properties/contacts, and filter on the internal 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 default Ryze AI connection could not search tickets on the test portal. | Keep ticket work for HubSpot's own Claude connector, which reads and edits tickets, and use Ryze AI for contacts, companies and deals. |
| Object not found. objectId is usually positive. | The status not_found for a deal read with the ID 0. No record has that ID. | Ask Claude to search for the deal first and reuse the id the search returns. |
| [hubspot] GET crm/v3/objects/contacts/{id}: provider returned text/html;charset=iso-8859-1 (status 404) "Error 404 Not Found" | The status not_found. HubSpot answered a read of an invented contact or blog post ID with an HTML page, and the read tool, which only parses JSON, passes on the 404. The real message ends with 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
- HubSpot shows an error during the install
- Your HubSpot user is not a Super Admin or lacks App Marketplace Access, or the portal's plan lacks a scope the app requires. 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 was revoked or permissions changed, for example after someone uninstalled the app under Connected Apps in HubSpot. Click Reconnect on the HubSpot card and authorize again.
- A field is missing from the results
- HubSpot returns a default set of properties unless the request names others. Ask Claude for the exact properties you need, such as Original Traffic Source drill-down 1.
- A whole object type is missing
- The connected HubSpot user may not have access to it. Check the user's permissions in HubSpot, or reconnect with a user who has that access.
- Results stop at 100 or 200 records
- hubspot__listObjects returns up to 100 records per page and hubspot__search up to 200. Ask Claude to keep paging until there are no more results.
- Campaign names do not match between the ad platform and HubSpot
- Drill-down values come from the utm_campaign parameter on your ad URLs. Campaigns without it, or with a utm_campaign that differs from the campaign name, will not match by name; ask Claude to list the unmatched values.
- HubSpot tools do not appear in Claude
- The Ryze AI help center says Claude keeps the tool list from the moment the connector is added. If HubSpot was connected in Ryze AI afterwards, remove the Ryze AI connector, add it again and open a new chat.
- Claude says a subscription is required
- The HubSpot tools need an active Ryze AI plan or free trial. Start the trial or update the card under Organization Settings, Billing, then retry.
Terms on this page
- Custom connector
- A remote MCP server you add to Claude yourself by pasting its address. Anthropic does not review it, and Claude never suggests it in a chat.
- Community label
- Anthropic's mark for a third-party directory connector that passed automated checks without an in-depth review. The Ryze AI listing carries it.
- Tool permissions
- The setting on each connector in Claude that makes a tool, or a group of tools, run at once, wait for your approval, or stay blocked.
- Portal
- One HubSpot account. A Ryze AI connection points at one portal, and a workspace can hold several, one of them starred as primary.
- Scope
- A permission a HubSpot app requests when it is installed. Each one opens a set of API endpoints and the data behind them.
- Filter group
- A set of filters in a HubSpot CRM search that a record must match together. A record that matches any one group is returned.
- Access token
- The short-lived HubSpot credential an OAuth app sends with each request. It lasts 30 minutes and is renewed with a longer-lived refresh token.
Sources: Claude docs: directory and custom connectors, Claude docs: verification, Claude docs: getting started, HubSpot scope reference, HubSpot CRM search guide, HubSpot OAuth tokens. Checked November 14, 2026.
Frequently asked questions
How do I connect Claude to HubSpot?
Connect HubSpot in a Ryze AI workspace: open Integrations, click Connect on HubSpot, sign in, choose the account and approve the permissions. Then in claude.ai open Customize, Connectors, Add, Add custom connector, paste https://connector.get-ryze.ai/mcp, click Connect, allow the workspace and start a new chat.
Is there a HubSpot MCP server for Claude?
Yes. The Ryze AI connector at https://connector.get-ryze.ai/mcp carries 5 HubSpot tools and goes in as a custom connector on any Claude plan. HubSpot's own remote MCP server at https://mcp.hubspot.com needs an MCP connector created in HubSpot for its client ID and secret, and HubSpot's ready-made Claude connector runs on it. Hosted services such as Composio and Zapier offer HubSpot servers too.
Does HubSpot have its own Claude connector?
Yes. HubSpot's help article for the HubSpot connector for Claude was first published on July 29, 2025. The connector needs a paid Claude plan (Pro, Max, Team or Enterprise), can view, create and update HubSpot records, and does not support delete. HubSpot also runs a remote MCP server at mcp.hubspot.com for builders who connect their own client or agent.
Which HubSpot connector should I use with Claude?
If you only work inside HubSpot, HubSpot's own connector covers more HubSpot objects. Ryze AI is the best HubSpot connector for tying Google Ads and Meta Ads spend to HubSpot contacts and deals in Claude, because one connection carries HubSpot and the ad platforms together. The caveat: tickets, custom objects and list editing are outside its HubSpot access.
Can I use HubSpot's Claude connector on the Free plan?
No. HubSpot's article asks for a paid Anthropic subscription: Pro, Max, Team or Enterprise. A Free Claude account can still hold one custom connector, which is enough for the Ryze AI connector.
What HubSpot permissions do I need to connect Claude?
You need to be a Super Admin or have App Marketplace Access in HubSpot; otherwise a Super Admin has to connect it. The portal must also include every scope the app requires, or HubSpot shows an error during install.
Which Claude plan do I need?
Anthropic lists custom connectors on every Claude plan: Free, Pro, Max, Ultra, Team and Enterprise. On Free you can add one custom connector. On Team and Enterprise an Owner or Primary Owner adds the Ryze AI connector first, then each member clicks Connect.
Is the Ryze AI connector verified by Anthropic?
No. Its listing in Claude's Connectors Directory carries the Community label, which means it passed automated checks without an in-depth review by Anthropic. Added by its address, it counts as a custom connector, which Anthropic does not review either.
Can Claude edit or delete HubSpot records?
Yes. Through Ryze AI, Claude can create and update contacts, companies, deals and CMS blog posts, and delete records or blog posts when you ask. Most deleted CRM records land in HubSpot's recycling bin, while a deleted blog post may not come back. Set write and delete tools to Needs approval in Claude so it asks first.
Can Claude read HubSpot tickets through Ryze AI?
No. A ticket search through the Ryze AI connection was refused with the status not_allowed in the November 14, 2026 test, and tickets are not among the access Ryze AI documents for HubSpot. HubSpot's own connector for Claude reads, creates and updates tickets.
Can Claude tell which ads produced a HubSpot contact or deal?
It can read the traffic source properties HubSpot sets: Original Traffic Source and its drill-downs, which deals and companies mirror from their contacts. With Google Ads or Meta Ads connected in the same workspace, Claude matches the utm_campaign values in those drill-downs to campaign names and adds the spend.
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 that Claude uses by default; name another account in chat to switch. For separate clients, use one Ryze AI workspace per client; one Claude connection covers up to 20 workspaces.
Does this work in Claude Desktop, Claude Code and ChatGPT?
Yes. Connectors added on claude.ai are available in Claude Desktop, and in Claude Code when it is signed in with the same Claude account. You can also run claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp --scope user, then /mcp to sign in. In ChatGPT, OpenAI gives full MCP to Business and Enterprise/Edu workspaces and read and fetch only to Pro.
Why do the HubSpot tools not show up in Claude?
The Ryze AI help center says Claude keeps the connector's tool list from the moment you add it. If you connected HubSpot in Ryze AI after adding the connector, remove the Ryze AI connector in Customize, Connectors, add it again and open a new chat.
How much does it cost to connect Claude 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 Claude?
Uninstall the app in HubSpot under Settings, Integrations, Connected Apps. You can also disconnect the portal in Ryze AI with the trash icon on the HubSpot card, or click Disconnect on the Ryze AI connector in Claude under Customize, Connectors.