How to connect Claude to HubSpot

Connect HubSpot once in Ryze AI, add one MCP URL to Claude, then ask about contacts and deals next to your Google Ads and Meta Ads spend.

Your MCP URL
https://connector.get-ryze.ai/mcp

Copies the link and opens Claude, Customize, Connectors, Add custom connector. See the steps

See pricing

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.

  1. In Ryze AI open Integrations, find HubSpot and click Connect
  2. Sign in to HubSpot, choose the account and approve the permissions
  3. In Claude open Customize, Connectors, then Add and Add custom connector, and paste the URL
  4. Click Connect if Claude shows it, pick the workspace, click Allow connection, open a new chat

Claude to HubSpot at a glance

FactDetail
Main way to connectThe 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 addresshttps://connector.get-ryze.ai/mcp, identical for every account
How you sign inTwo 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 tools5 in total. hubspot__read, hubspot__search and hubspot__listObjects fetch data, hubspot__write creates and updates, hubspot__delete archives
Changes to HubSpotPossible through the write and delete tools. Put both on Needs approval under Tool permissions if Claude should ask before each change
Claude planAny 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 setupclaude.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 connectA Super Admin, or a user who holds App Marketplace Access
Ryze AI pricePaid Ads at $89 per month with a 7-day free trial. Adding the connector costs nothing
HubSpot's own option for ClaudeThe HubSpot connector for Claude, on paid Claude plans. It covers more object types, including tickets, and has no delete
Last testedConnector 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.

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

    HubSpot screen titled Connecting your Ryze AI account to HubSpot, with the buttons Create a new HubSpot account and Sign in to your HubSpot account
  3. 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.

    The HubSpot window in Ryze AI after connecting, showing an example account by its HubSpot domain with the primary star, blog and author choices, the Add one more account button and the trash icon
  4. 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.

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

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

QuestionWhat 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 user

Then 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 AIHubSpot scope
Read and edit contactscrm.objects.contacts.read, crm.objects.contacts.write
Read and edit companiescrm.objects.companies.read, crm.objects.companies.write
Read and edit dealscrm.objects.deals.read, crm.objects.deals.write
Read contact listscrm.lists.read
Look up record ownerscrm.objects.owners.read
Read and edit CMS blog contentcontent (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 connectionMatching scope entryWhat HubSpot says it opensAccounts that can grant it
Contacts, read and write (required)crm.objects.contacts.read, crm.objects.contacts.writeSeeing contact details, and creating, changing or deleting contactsEvery HubSpot account
Companies, read and write (required)crm.objects.companies.read, crm.objects.companies.writeSeeing company details, and creating, changing or deleting companiesEvery HubSpot account
Deals, read and write (required)crm.objects.deals.read, crm.objects.deals.writeSeeing deal details, and creating, changing or deleting dealsEvery HubSpot account
Owners, read (required)crm.objects.owners.readThe users assigned to a CRM recordEvery HubSpot account
Contact property settings, read (required)crm.schemas.contacts.readHow the contact properties are set upEvery HubSpot account
Deal property settings, read and write (required)crm.schemas.deals.read, crm.schemas.deals.writeSeeing and changing how the deal properties are set upEvery HubSpot account
Contact lists, read (required)crm.lists.readThe details of contact listsEvery HubSpot account
Content (required)contentHubSpot's content APIs, blogs and website and landing pages among themCMS Hub or Marketing Hub, Professional or Enterprise
Files (optional)filesThe file manager, through a legacy scope that HubSpot recommends existing apps replace with granular onesEvery HubSpot account
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 its 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

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.

ToolTypeWhat it does
hubspot__readReadSends a GET request to a HubSpot JSON resource by its path: one record, property definitions, owners, a list or blog posts.
hubspot__searchReadRuns 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__listObjectsReadLists the records of one object type, up to 100 per page, with the properties you name and the IDs of associated records.
hubspot__writeWriteCreates or updates contacts, companies, deals and blog posts, and adds associations between records. Its two methods are CREATE and UPDATE.
hubspot__deleteDeleteArchives 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

LimitNumberSet by
Results per search page10 when you name no limit, 200 at most. A request for 201 was refused in the testHubSpot
Results per search query10,000. Paging past that point returns a 400 errorHubSpot
Filters in one search5 filter groups of up to 6 filters each, and 18 filters in allHubSpot
Operators in hubspot__search12, among them EQ, BETWEEN, IN, HAS_PROPERTY and CONTAINS_TOKENRyze AI tool definition
Search calls per second5 for each HubSpot account. Search responses carry no rate limit headersHubSpot
Size of one search request3,000 characters. A longer request body returns a 400 errorHubSpot
Records per list page100: the cap of hubspot__listObjects, and the most contacts HubSpot returns in one requestRyze AI tool definition and HubSpot
Path length for read, write and delete2,048 charactersRyze AI tool definitions
Requests every 10 seconds110 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 headerHubSpot
Recycling binDeleted CRM records can be restored for 90 daysHubSpot
Size of one tool resultAbout 150,000 charactersAnthropic, for claude.ai and Claude Desktop
Length of one tool call240 secondsAnthropic, 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 askedTool and inputAnswer
Contacts by emailhubspot__search, email equal to a random string of 20 lettersWorked, with the empty result {"total":0,"results":[]}
Companies by domainhubspot__search, domain equal to 20 random lettersWorked, with the same empty shape
Deals by deal namehubspot__search, dealname equal to 20 random lettersWorked, with the same empty shape
One contact from the listhubspot__listObjects, limit 1, only the property hs_object_idWorked. 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 existhubspot__search with a filter on a made-up property nameRefused with Error 400
201 contacts in one pagehubspot__search with limit 201 and a filter that could not matchRefused with Error 400, category VALIDATION_ERROR
Ticketshubspot__search on tickets with a filter that could not matchRefused with the status not_allowed
The deal with ID 0hubspot__read of crm/v3/objects/deals/0The status not_found
A contact with an invented IDhubspot__read of a contact path with an 18-digit IDThe status not_found, after HubSpot sent an HTML 404 page
A blog post with an invented IDhubspot__read of cms/v3/blogs/posts/ with an 18-digit IDThe status not_found, with the same HTML 404 page
The blog post with ID 1hubspot__read of cms/v3/blogs/posts/1The 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.

JobWhat to ask ClaudeToolOn the default connection
Contact lookupLook up the HubSpot contact with the email I paste and give me their lifecycle stage, owner and create date.hubspot__searchYes
Deals from the last 30 daysWhich deals were created in HubSpot in the last 30 days? Give the name, amount and stage of each.hubspot__searchYes
Deals that went quietFind open deals nobody has changed in 30 days and tell me who owns each one.hubspot__search, then hubspot__read on crm/v3/ownersYes. The owners read was not part of the test
Account mapFind the company on this domain and show every contact and deal linked to it.hubspot__search, then hubspot__listObjects with associationsYes. The test did not ask for associations
Contacts in pagesWalk through all contacts, 100 per page, with lifecycle stage and create date.hubspot__listObjectsYes
Property names before a filterGive me the internal names of my deal properties so we can build a search.hubspot__read on crm/v3/properties/dealsYes. Not run in the test
New deal with linksCreate a deal for this company, attach its main contact, and show me the new record.hubspot__writeYes. Not run, because it changes the portal
Property changeSet this contact's lifecycle stage to the value I give you, then read the contact back.hubspot__write with UPDATE, then hubspot__readYes. Not run
Duplicate removalDelete the contact with this ID.hubspot__deleteYes. Most CRM deletes can be restored from the recycling bin for 90 days. Not run
Ticket reviewShow the open tickets for this company.hubspot__searchNo. 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.

WayRuns whereSetup in ClaudeWhat it reaches in HubSpotPrice
Ryze AI connector (the main way)Hosted by Ryze AI. One address for everyoneCustomize, 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 AIContacts, 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 objectsPaid Ads at $89 per month with a 7-day free trial. Fits every Claude plan, Free included
HubSpot connector for ClaudeHosted by HubSpot. Claude on web, desktop and mobileHubSpot'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 itContacts, 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 accountNo HubSpot price. Needs a paid Anthropic plan: Pro, Max, Team or Enterprise
HubSpot remote MCP serverHosted by HubSpot at https://mcp.hubspot.comCreate 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 instead36 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 toolNo 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 serverHubSpot'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 tabTwo plugins: HubSpot Sales for contacts, deals and onboarding, and HubSpot Partner for Solutions Partner client records. The README names no toolsNo price stated. Apache-2.0 license
HubSpot Agent CLI (beta)A program on your computer that an agent runsInstall 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 appCRM 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 betaNo price stated. Beta, under HubSpot's Developer Beta Terms
ComposioHostedComposio'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 app354 HubSpot tools and 2 triggers by Composio's count, batch create, update and archive includedFree with 10,000 tool calls a month, per the pricing page. Standard is $18 per seat per month
Zapier MCPHostedAdd 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 clientsThe HubSpot actions you turn on in Zapier. Zapier prints no total2 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.aiHostedConnect HubSpot as a data source in Windsor.ai, then add Windsor MCP from Claude's Connectors menuReporting access to 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 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 integrationsRead-only analysis of the loaded datasets, handed to the AI as aggregates rather than single recordsA 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 onlyA 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 working21 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 latestNo price stated. MIT license
baryhuang/mcp-hubspot (open source)A Docker container on your computer, in Claude Desktop onlyA docker command entry in claude_desktop_config.json with a HubSpot access token, or the Smithery install for the Claude client given in the README7 tools for contacts, companies, company activity and recent conversations. No deal toolsFree, 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

DateWhat happened
November 25, 2024Anthropic open-sourced the Model Context Protocol, with local MCP servers in the Claude Desktop apps on every plan.
May 1, 2025Claude 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, 2025HubSpot put its npm MCP server, @hubspot/mcp-server, into public beta.
July 14, 2025Anthropic opened its directory of connectors on web and desktop.
July 29, 2025HubSpot first published its help article for the HubSpot connector for Claude.
September 1, 2025HubSpot's remote MCP server went into its first public beta.
February 25, 2026Claude Desktop gained a Customize section that holds skills, plugins and connectors.
April 13, 2026HubSpot's remote MCP server became generally available to all HubSpot accounts, with write access and OAuth 2.1 with PKCE.
August 2026The Ryze AI listing joined Claude's Connectors Directory, going by the Added date on the listing.
September 15, 2026HubSpot's Claude connector and remote MCP server gained custom objects, activable objects and Leads, quotes in public beta and read-only conversations.
October 26, 2026Older HubSpot accounts lost the option to create new legacy private apps, four weeks after new accounts. Service Keys are HubSpot's replacement.
October 30, 2026HubSpot'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, 2026Anthropic began letting connected tools open beside the chat or full screen, rolling out on web and desktop.
November 12, 2026HubSpot 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.

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

MessageWhat it meansWhat 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.

Connect HubSpot and your ad accounts to Claude

One Ryze AI workspace holds HubSpot, Google Ads and Meta Ads. 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 Claude connector FAQ or email Ryze AI support.