By Ira Bodnar, Ryze AI · Updated · Connector tested November 14, 2026
Quick answer
The main way to connect Le Chat to HubSpot is the Ryze AI connector. Link your HubSpot portal in Ryze AI with a HubSpot sign-in, then, in Mistral Vibe (the name Le Chat has carried since May 28, 2026), open Connectors, click + Add Connector, choose the Custom MCP Connector tab, enter a name such as RyzeAI with the server URL https://connector.get-ryze.ai/mcp, click Connect and finish the Ryze AI sign-in.
- In Ryze AI open Integrations, click Connect on the HubSpot card, pick the portal and approve the permissions
- In Mistral Vibe open Connectors, + Add Connector, then the Custom MCP Connector tab
- Enter a name without spaces, such as RyzeAI, and the URL above, then click Connect
- Finish the Ryze AI sign-in, choose workspaces, click Allow connection and start a new chat
Le Chat to HubSpot at a glance
| Fact | Detail |
|---|---|
| Main way | The Ryze AI connector, added to Mistral Vibe as a Custom MCP Connector |
| Address to enter | https://connector.get-ryze.ai/mcp |
| Sign-in | A HubSpot OAuth sign-in done once in Ryze AI, then a Ryze AI sign-in from Mistral, which detects OAuth 2.1 with dynamic client registration. No client ID, secret or API key to type |
| HubSpot tools | 5: 3 that read, 1 that writes and 1 that deletes |
| Changes to HubSpot | Yes. The write tool creates or updates contacts, companies, deals and blog posts, and the delete tool archives records when you ask. Mistral Vibe asks before a call that creates, modifies, sends, posts or deletes |
| Other data in the same chat | The same connector address serves the other platforms connected in your Ryze AI workspace. The HubSpot tools reach one HubSpot portal per connection |
| Mistral requirement | An administrator adds the connector. On Free, Pro and Student the account owner is the administrator. No minimum plan is named |
| Ryze AI price | Paid Ads, $89 per month with a 7-day free trial. Adding the connector is free |
| HubSpot's own option | A remote MCP server at https://mcp.hubspot.com, set up with a client ID and secret made in HubSpot. HubSpot names no Le Chat steps, and it was not tried in Vibe Work |
| Last tested | The HubSpot tools through the Ryze AI connector on November 14, 2026, from Claude Code, with read-only calls. Nothing was run inside Mistral Vibe |
Before you start
- Administrator rights in Mistral. Mistral's docs call adding a custom MCP connector an administrator action, and on Free, Pro and Student plans the account owner is the administrator by default. The docs name no minimum plan. On a team or organization account, ask an administrator to add it.
- A HubSpot user who can install apps. HubSpot says installing an app takes a Super Admin or a user with App Marketplace access. Ryze AI signs in with HubSpot OAuth and shows the permissions to approve, so no API key or private app token is pasted.
- A Ryze AI workspace on a plan or free trial. Paid Ads costs $89 per month with a 7-day free trial, and annual billing takes 30% off the first year. Adding the connector is free; the HubSpot tools run only with an active plan or trial.
- A server reachable over HTTPS. Mistral requires a valid TLS certificate. The Ryze AI address meets that, so enter it exactly as written.
How to connect Le Chat to HubSpot
Setup has two parts. HubSpot is linked inside Ryze AI first, and then Mistral Vibe gets the address of the Ryze AI connector. The Mistral half follows Mistral's MCP connectors docs. Ryze AI has no help center page for Mistral, and nobody ran the sign-in inside Mistral Vibe while this guide was written, so check the errors section below if a screen looks different. The HubSpot connection is saved in your Ryze AI workspace, and the workspace is what you pick when you sign in from Mistral.
Check your HubSpot permission
Sign in to HubSpot as a Super Admin or as a user with App Marketplace access. Other users need a Super Admin to approve the install first.
Connect HubSpot in Ryze AI
In the Ryze AI app open Integrations, find the HubSpot card and click Connect. Sign in to HubSpot, choose the account (portal) and click Choose Account. Approve the requested permissions, and HubSpot returns you to Ryze AI with the connection saved. Optional, for publishing articles: click View on the card, pick the Blog and the Author and click Save.
Open Connectors in Mistral Vibe
Go to chat.mistral.ai (the address stayed the same when Le Chat became Mistral Vibe), open the Connectors page from the sidebar and click + Add Connector. Switch to the Custom MCP Connector tab.
Enter the connector name and URL
Connector name: a unique identifier with no spaces or special characters, for example RyzeAI. Server URL: https://connector.get-ryze.ai/mcp. The description is optional.
Click Connect
Mistral works out the sign-in method from the URL. Ryze AI uses OAuth 2.1 with dynamic client registration, so there is no client ID or secret to enter.
Finish the Ryze AI sign-in
Complete the Ryze AI sign-in when Mistral prompts, choose the workspace that holds your HubSpot connection and click Allow connection. Open a new chat and ask a HubSpot question. If the connector was added before HubSpot was connected, remove it, add it again and open a new chat.
There is no Ryze AI help center page for Mistral Vibe. The Ryze AI HubSpot guide covers connecting a HubSpot portal on the Ryze AI side.
Sources: Mistral docs: MCP connectors, Mistral docs: Connectors, Mistral help: Le Chat is now Vibe, HubSpot: install apps from the Marketplace, Ryze AI HubSpot guide. Checked November 15, 2026.
Approvals and Always allow
Each Mistral user decides how much a function may do without asking. To pre-authorize only the reads you trust:
- Open Connectors, then the My Connectors tab.
- Open the Ryze AI card and go to its Functions tab.
- Switch Always allow on for hubspot__search, hubspot__listObjects and hubspot__read if you want lookups to run without a prompt each time.
- Leave Always allow off for hubspot__write and hubspot__delete, so Mistral asks before each one.
- Use Refresh tools on the same tab to reload the function list after Ryze AI changes it.
Mistral's Safety and approvals page says Work pauses before anything that creates, modifies, sends, posts or deletes, and offers three answers: Continue for that one action, Always allow for that function until the session ends, or Decline. The toggles belong to each user, so yours do not change a teammate's settings. Mistral advises keeping write functions on manual approval until you trust the connector. The approval prompt on the write and delete tools is the control Mistral gives you.
Sources: Mistral docs: MCP connectors, Mistral docs: Safety and approvals. Checked November 15, 2026.
Vibe Work and Vibe Code
Vibe Work and the old Le Chat address
Mistral's changelog and launch post date the change from Le Chat to Vibe to May 28, 2026, with the same chat.mistral.ai address and login. Chat and Work merged into one experience on September 22, 2026. Mistral's old docs link for MCP connectors now redirects to the Vibe docs, so a tutorial that still says Le Chat describes this same screen.
Vibe Code (CLI and VS Code extension)
Vibe Code, the coding side of Vibe, reads MCP servers from ~/.vibe/config.toml or a project's .vibe/config.toml and adds a remote one with vibe mcp add. It can also start a local server from a command, which Vibe Work cannot. Ryze AI has not reviewed the Vibe Code setup, so this guide gives steps for Vibe Work only.
Vibe Work and MCP: the facts in one table
| Topic | What Mistral pages say |
|---|---|
| Product name | Vibe. Work, on the web and in the iOS and Android apps, is the old Le Chat. Mistral does not say whether a custom connector can be added or used from the apps |
| Where a server is added | The Connectors page from the sidebar, + Add Connector, Custom MCP Connector tab |
| Plan | The connector docs name no minimum plan. Mistral's pricing page shows a check mark for the beta Custom MCP connectors feature under Free, Pro, Team and Enterprise |
| Who can add one | An administrator, which on Free, Pro and Student is the account owner by default |
| Transport | A remote address over HTTPS with a valid TLS certificate. Mistral shows no field for a local command |
| Sign-in | Detected from the URL: none, a Bearer token or Basic Auth in the Authorization header, or OAuth 2.1 with dynamic client registration |
| Approval | A prompt before actions that create, modify, send, post or delete: Continue, Always allow for the session, or Decline |
| Picking the connector | Work calls a connected connector when it fits the request. The + icon or / in the chat box, then Tools, picks one for a task |
| Not supported yet | Dynamic tool discovery, resources and automatic prompt templates |
| Where it is managed | Users: Connectors, My Connectors tab. Admins: Admin Panel, Administration, Connectors, set to Allowed, Restricted or Blocked per workspace |
Sources: Mistral docs: Vibe, Mistral docs: MCP connectors, Mistral docs: Safety and approvals, Mistral docs: Admin Panel connectors, Mistral docs: Vibe Code MCP servers, Mistral pricing. Checked November 15, 2026.
HubSpot access and scopes
Three gates sit between Mistral Vibe and your CRM. Mistral decides who may add the connector and which calls ask first, HubSpot decides who may install the Ryze AI app and what scopes it holds, and Ryze AI decides which portal is reachable.
- Who can install
- HubSpot requires a Super Admin or a user with App Marketplace access to install an app. Everyone else needs a Super Admin. Ryze AI also has a listing in the HubSpot Marketplace, which you can start from.
- Which portal
- One HubSpot portal per connection. Several portals can be connected to one Ryze AI workspace: click View on the card, then Add one more account. One is the primary (marked with a star) and is used unless you name another, and every tool takes an optional connection_id.
- What the token can see
- HubSpot says an OAuth access token carries the scopes the app asked for and does not mirror the installing user's own record permissions. In HubSpot's example, a user who can view only owned contacts but authorizes the contacts read scope gives the app a token that can view all contacts.
- What Mistral lets through
- Work asks before a call that creates, modifies, sends, posts or deletes. In an organization, an admin can set the Connectors setting to Allowed, Restricted or Blocked per workspace, so an admin may have switched custom connectors off for yours.
The Ryze AI facts list the permissions in words: contacts, companies and deals read and write, owners read, contact schema read, deal schema read and write, lists read, and content. Optional ones are files, CMS functions, knowledge base and membership. HubSpot drops an optional scope automatically when the chosen portal has no access to that tool, while a required scope has to be granted or the install fails.
Scopes the HubSpot connection asks for
The table maps each permission to the HubSpot scope that matches it in HubSpot's scope reference. The Ryze AI facts give words and not scope strings, and the HubSpot consent screen is the source of truth, so treat the strings as the closest match.
| Ryze AI permission | HubSpot scope | What HubSpot says it covers | Availability |
|---|---|---|---|
| Contacts read and write | crm.objects.contacts.read, crm.objects.contacts.write | View properties and details about contacts. Write adds creating, deleting and changing them | All accounts |
| Companies read and write | crm.objects.companies.read, crm.objects.companies.write | View properties and details about companies. Write adds creating, deleting and changing them | All accounts |
| Deals read and write | crm.objects.deals.read, crm.objects.deals.write | View properties and details about deals. Write adds creating, deleting and changing them | All accounts |
| Owners read | crm.objects.owners.read | View details about users assigned to a CRM record | All accounts |
| Contact schema read | crm.schemas.contacts.read | View property settings for contacts | All accounts |
| Deal schema read and write | crm.schemas.deals.read, crm.schemas.deals.write | View, create, delete or change property settings for deals | All accounts |
| Lists read | crm.lists.read | View details about contact lists | All accounts |
| Content | content | Access to content APIs, including website pages, landing pages and blog APIs | CMS Hub Professional or Enterprise, or Marketing Hub Professional or Enterprise only |
| Optional: CMS functions | cms.functions.read, cms.functions.write | View and write serverless functions and secrets | Content Hub Enterprise only |
| Optional: knowledge base | cms.knowledge_base.articles.read and related scopes | View knowledge articles through the GraphQL API | Service Hub Professional or Enterprise only |
| Optional: membership | cms.membership.access_groups.read, cms.membership.access_groups.write | View, create, edit and delete membership access groups | Service Hub or Content Hub Professional or Enterprise only |
Not on the table: tickets, custom objects, list editing and sensitive data properties. A ticket search on the default connection was refused when tested, custom object scopes are not requested, and the Ryze AI facts say lists are read only. HubSpot's own connectors and remote MCP server cover more objects, as the comparison below shows.
What the HubSpot token covers
HubSpot's Marketplace listing for Ryze AI shows eight shared data types: contacts, contact properties, companies, deals, deal properties, contact lists, owners and CMS blog posts. They match the required permissions one for one. Whether a portal on a lower tier than the content scope lists can finish the install was not tested.
Sources: HubSpot scopes reference, HubSpot: working with OAuth, HubSpot: install apps from the Marketplace, Ryze AI in the HubSpot Marketplace, Ryze AI HubSpot guide, Ryze AI multiple accounts guide. Checked November 14, 2026.
Removing access
You can cut access in three places. In Ryze AI, click View on the HubSpot card and disconnect the portal with the trash icon. In HubSpot, open Settings, Integrations, Connected Apps, then Actions on the app and Uninstall. In Mistral Vibe, open Connectors, My Connectors and remove the Ryze AI connector.
What Le Chat can do in HubSpot
The Ryze AI connector gives Mistral Vibe 5 HubSpot tools: 3 that read, 1 that writes and 1 that deletes. Mistral calls an action of a connector a function; this page says tool. The 5 names were loaded from the live connector on November 14, 2026 and match the Ryze AI facts.
| Tool | Type | What it does |
|---|---|---|
| hubspot__listObjects | Read | Lists CRM records of one object type page by page, with the properties you choose and the IDs of associated records. |
| hubspot__search | Read | Searches CRM records through the HubSpot CRM Search API with filter groups, sorts, a text query and chosen properties. |
| hubspot__read | Read | Sends a GET request to a HubSpot JSON API resource, such as a record, property definitions, owners, a list or blog posts. |
| hubspot__write | Write | Creates or updates a HubSpot resource, such as a contact, company, deal or blog post, and adds associations between records. |
| hubspot__delete | Delete | Deletes (archives) a HubSpot resource by ID, such as a CRM record or blog post. |
Mistral sorts connector functions into read and write. Work asks before a call that creates, modifies, sends, posts or deletes, and you can switch on Always allow per function under Connectors, My Connectors, the Ryze AI card, Functions tab. Mistral suggests keeping write functions on manual approval, so leave Always allow off for hubspot__write and hubspot__delete. Mistral's pages do not say whether a custom connector's read functions ask by default. The Ryze AI chat is a separate place: its Tool approvals picker starts on Skip all approvals, and scheduled tasks run without an approval step. Most CRM deletes go to HubSpot's recycling bin, where records can be restored for up to 90 days, but a deleted blog post may not be recoverable.
Limits in numbers
These figures are HubSpot's, from its developer docs and knowledge base, and the unit is named in each row. The first one is an inference: it is HubSpot's rule for OAuth apps distributed through the HubSpot Marketplace, Ryze AI has a Marketplace listing, and no HubSpot page states it for Ryze AI. No response in the test carried a rate limit header. Mistral's docs print no cap on the number of tools or calls.
| Limit | Number |
|---|---|
| Burst limit for Marketplace OAuth apps | 110 requests every 10 seconds per HubSpot account that installs the app, not counting the CRM Search API. The API limit increase add-on does not raise it |
| CRM Search API rate | 5 requests per second per account. Search responses carry none of the rate limit headers |
| Search page size | 10 records by default, 200 at most. The connector refused a limit of 201 with limit must be in range [0..200] |
| Listing page size | hubspot__listObjects accepts a limit up to 100. HubSpot's contacts guide gives 100 per list request |
| Search result cap | 10,000 results in total for any query. Paging past 10,000 returns a 400 error |
| Search filters | At most 5 filter groups with up to 6 filters each, 18 filters in total. Filters in a group are joined with AND, groups with OR |
| Search query length | 3,000 characters at most in a request body |
| Default properties | A search returns a fixed set unless you name properties. Contacts: firstname, lastname, email, lastmodifieddate, hs_object_id, createdate |
| Batch size | Batch operations are limited to 100 records at a time |
| Path length in Ryze AI tools | 2,048 characters at most for the path argument of read, write and delete |
| Access token life | OAuth access tokens expire after 30 minutes, and the app refreshes them with a refresh token |
| Past the limit | HubSpot answers 429. The daily limit resets at midnight in the account's time zone |
| Search delay | New or updated records may take a few moments to appear in search. Archived records never appear |
| Recycling bin | Deleted records can be restored up to 90 days after deletion. Permanent or GDPR deletions skip the bin |
| HubSpot's own connectors | The connectors for ChatGPT and Claude create or update at most 10 records per bulk request. This applies to those connectors, not to the Ryze AI connector |
| Connector name in Mistral | Unique, with no spaces or special characters |
Sources: HubSpot API usage guidelines, HubSpot CRM search guide, HubSpot contacts API guide, HubSpot: manage OAuth tokens, HubSpot: restore deleted records, HubSpot connector for ChatGPT, Mistral docs: MCP connectors. Checked November 14, 2026.
First 3 prompts to run
Each prompt below says what it asks for and which tool it uses. The answers depend on your own portal, so no sample figures appear here.
1. Find a contact by email
Use the RyzeAI connector to find the HubSpot contact with the email I give you and show their lifecycle stage, owner and create date.
Tools used: hubspot__search
What comes back: A search on the contacts object filtered by email, with the properties you named. An empty result comes back as a total of 0.
2. Deals created in the last 30 days
With RyzeAI, search HubSpot deals created in the last 30 days and list each deal name, amount and stage.
Tools used: hubspot__search
What comes back: A list of deals filtered by create date, with the name, amount and stage properties. Nothing is changed.
3. Check which properties exist
Ask RyzeAI to read the HubSpot contact property definitions so I can see which internal names I can filter on.
Tools used: hubspot__read
What comes back: The property definitions for contacts. HubSpot rejects a filter on a property that does not exist, so this is a good first read.
Start with prompts that only read. When Mistral asks permission for a write, check the action it describes before you click Continue.
10 jobs to hand to Le Chat
Ten jobs to give Le Chat once the connector is in, each with its Ryze AI tool. Name the RyzeAI connector in the request, or pick it from the Tools menu in the chat box. The searches and the contact listing were run on November 14, 2026; the rest rely on the Ryze AI facts and HubSpot's docs, and nothing that changes the portal was run.
| Job | Ask Le Chat | Tool | Works on the default connection |
|---|---|---|---|
| Contact lookup | Find a contact by email and show the properties I name. | hubspot__search | Yes. A contacts search was run |
| Recent deals | List deals created in the last 30 days with name, amount and stage. | hubspot__search | Yes. A deals search was run |
| Stale deals | Find open deals with no change in 30 days and show the owner of each. | hubspot__search, then hubspot__read on the owners path | Yes. The owners read was not run |
| Company and its records | Find a company by domain and list its associated contacts and deals. | hubspot__search, then hubspot__listObjects with associations | Yes. A companies search was run; associations were not requested |
| Contact paging | Page through contacts with lifecycle stage and create date. | hubspot__listObjects | Yes. Listing with a limit of 1 returned a paging cursor |
| Property inventory | Show which contact and deal properties exist before I build a filter. | hubspot__read on the properties paths | Yes. Not run |
| List details | Read a contact list and its details. | hubspot__read on the lists path | Yes. Read only, and not run |
| New deal | Create a deal and associate it with a company and a contact. | hubspot__write | Yes. Not run, because it changes the portal |
| Property update | Update one property on a contact, company or deal. | hubspot__write | Yes. Not run |
| Duplicate cleanup | Delete the duplicate contact I name by ID. | hubspot__delete | Yes. Not run. Goes to the recycling bin |
5 ways to connect Le Chat to HubSpot
A custom connector in Vibe Work has to point at a remote MCP server over HTTPS, and Work cannot start a local command. Five hosted ways into HubSpot fit that shape. The Ryze AI connector is the main way: one HubSpot sign-in saved in Ryze AI, one address in Mistral and 5 tools. None of the other four vendors names Le Chat or Mistral on the pages read on November 14, 2026, and none was tried in Vibe Work.
| Way | Runs where | Setup in Mistral Vibe | What it reaches in HubSpot | Price |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Hosted by Ryze AI, one address for every user. The same address works in Claude, ChatGPT and other MCP clients | An administrator adds a Custom MCP Connector named, for example, RyzeAI with https://connector.get-ryze.ai/mcp, clicks Connect and signs in. HubSpot is linked once in Ryze AI with OAuth | 5 tools: search, list and read for CRM records, owners, lists and blog posts, plus a write and a delete tool. Contacts, companies and deals. One portal per connection, no tickets or custom objects | Paid Ads $89 per month, 7-day free trial. Adding the connector is free |
| HubSpot's remote MCP server | Hosted by HubSpot at https://mcp.hubspot.com | In HubSpot, Development, MCP Connectors, Create MCP connector gives a client ID and secret for an OAuth client with PKCE. Mistral shows no field for a client ID or secret, so this pairing is unproven. HubSpot's pages do not mention Le Chat | 36 tools in the documented list: CRM records including tickets and leads, activities, blog posts, landing pages, campaigns and content analytics. Its docs list no delete tool | No price stated on the pages read |
| Composio | Hosted | A remote MCP entry at https://connect.composio.dev/mcp, then authorizing HubSpot in the browser through Composio's managed OAuth app. Le Chat is not named on the HubSpot toolkit page, which says Claude, Cursor and ChatGPT | 354 tools and 2 triggers on the toolkit page, read and write, including batch create, update and archive | Pricing page: Free $0 with 10,000 tool calls per month, Standard $18 per seat per month. A FAQ on another page gives a different free allowance |
| Zapier MCP | Hosted | Add Zapier as a connector and sign in. Zapier turns on actions for apps already linked to your Zapier account. Its client lists name Claude, ChatGPT, Cursor, Codex, Gemini Enterprise, Grok, VS Code and Windsurf, and Le Chat is not among them | The HubSpot actions you enable from your Zapier account. Zapier prints no total for HubSpot | No separate MCP price. Each successful tool call uses 2 tasks from your Zapier plan |
| Windsor.ai (Windsor MCP) | Hosted | Connect HubSpot as a data source in Windsor.ai, then add Windsor MCP to the assistant. Windsor's pages name Claude, ChatGPT, Copilot, Gemini, Perplexity and Cursor, and not Le Chat | Reporting access to HubSpot data, 1,141 fields on the connector page. The pages do not show write actions for HubSpot | Windsor MCP is on every plan, including a free plan with 1 data source. Basic is $23 per month on monthly billing |
Other HubSpot options left out of the table
- HubSpot's connectors for ChatGPT, Claude, Gemini and Microsoft Copilot. HubSpot lists these four as its live connectors. Each sits inside its own assistant, so none is an option in Mistral Vibe.
- HubSpot Developer MCP server, Agent CLI and @hubspot/mcp-server. They run on your computer. The Developer MCP server covers app and CMS development and has no CRM record tools, and the npm package signs in with a private app token, which HubSpot is phasing out for new apps. Vibe Work takes only a remote HTTPS address.
- Open source servers such as baryhuang/mcp-hubspot. It runs as a Docker container on your machine with 7 tools for contacts, companies and engagements, which does not fit a connector form that wants a remote address.
- Coupler.io. It loads HubSpot datasets through its own data flows and gives read-only aggregated answers. Its pages disagree on which plan includes the MCP server, so it is left out of the table.
- Mistral's connector directory. Vibe Work also offers Featured Connectors and an MCP Connectors directory. This guide did not check whether either holds a HubSpot connector.
Which one to pick
Ryze AI is the best way to connect Le Chat to HubSpot for searching and editing contacts, companies and deals from one MCP URL, with one caveat: it has 5 tools and no tickets, custom objects or list editing. HubSpot's own remote server reaches far more of HubSpot with 36 tools, but its setup asks for a client ID and secret that Mistral's form has no field for, and HubSpot does not name Le Chat. Composio, Zapier and Windsor.ai make sense when your team already uses one of them for other apps, and Windsor's pages show reporting rather than record edits.
Sources: HubSpot remote MCP server docs, HubSpot AI tools, HubSpot connector for Claude, Composio HubSpot toolkit, Composio pricing, Zapier HubSpot MCP, Zapier MCP quickstart, Windsor MCP, Windsor.ai pricing, Coupler.io HubSpot MCP, baryhuang/mcp-hubspot on GitHub, Mistral docs: MCP connectors, Ryze AI HubSpot guide. Checked November 14 and 15, 2026.
Le Chat, HubSpot and MCP: dates that matter
| Date | What happened |
|---|---|
| September 1, 2025 | HubSpot's remote MCP server went into public beta across all hubs and tiers. |
| September 2, 2025 | Le Chat gained custom MCP connectors and a directory of more than 20 connectors (beta), open to every user, Free plan included. |
| April 13, 2026 | HubSpot's remote MCP server became generally available to all HubSpot accounts with write access added, and OAuth 2.1 with PKCE was required. |
| May 28, 2026 | Le Chat became Vibe at chat.mistral.ai, and Mistral's docs moved from /le-chat to /vibe. |
| June 24, 2026 | Mistral added per-workspace and per-tool connector controls for admins, connectors that hold several logins, and the Connectors Debugger. |
| August 27, 2026 | HubSpot announced that creating legacy private apps would be disabled, on September 28, 2026 for new accounts and October 26, 2026 for older ones. Existing private apps keep working. |
| September 15, 2026 | HubSpot said its MCP server and Claude connector would gain custom objects, leads and read-only conversations. The Ryze AI facts list no custom object scope, so this guide claims none. |
| September 15, 2026 | HubSpot announced the end of support for API versions v1 to v3 with enforcement in September 2027, and for v4 on March 30, 2027. The Ryze AI facts say nothing about how the tools will handle it. |
| September 22, 2026 | Chat and Work merged into one Vibe experience. Enterprise organizations move from October 1, 2026, within about six months. |
| October 30, 2026 | HubSpot put connector access to Sensitive Data into public beta for ChatGPT, Claude and Copilot, and engagements only for Gemini and its remote MCP server, when a Super Admin allows it. |
| December 4, 2026 | HubSpot's Pipelines API V1 stops responding. |
Sources: HubSpot changelog: remote MCP server beta, HubSpot changelog: remote MCP server GA, HubSpot changelog: legacy private apps, HubSpot changelog: Fall 2026 Spotlight, HubSpot changelog: legacy APIs and apps, HubSpot changelog: October 2026 rollup, HubSpot changelog: Pipelines API V1 sunset, Mistral changelog, Mistral release notes, Mistral news, September 2, 2025, Mistral news, May 28, 2026, Mistral news, June 24, 2026. Checked November 14 and 15, 2026.
How this guide was tested
Two things stand behind this guide: 11 read-only HubSpot calls through the Ryze AI connector on November 14, 2026, run from Claude Code against a portal already connected in a Ryze AI workspace, and the vendors' own pages as read on November 14 (HubSpot) and November 15 (Mistral). No record content is kept here.
| What was run | What came back |
|---|---|
| The 5 tool names (November 14, 2026) | hubspot__listObjects, hubspot__search, hubspot__read, hubspot__write and hubspot__delete loaded by name from the connector, and their definitions matched the Ryze AI facts. Every tool takes a workspace argument and an optional connection_id. |
| Searches on contacts, companies and deals | Three searches with a filter that could not match returned the valid empty shape {"total":0,"results":[]}. |
| Listing contacts | A list with a limit of 1 returned one result and a paging block with an after value. HubSpot added the create and last modified dates to the one property asked for. |
| Searches that failed on purpose | A limit of 201, a filter on a property that does not exist and a ticket search were refused. The messages are in the errors table below. |
| Reads of records that do not exist | Reads of a deal ID 0, a made-up contact ID and two made-up blog post IDs came back as not found. They do not show whether blog reads work on a portal. |
| Mistral documentation (November 15, 2026) | The add steps, the administrator rule, the sign-in methods and the unsupported features were read on Mistral's docs. |
Not run: any step inside Mistral Vibe. No Mistral account was used, so the Connectors form, the sign-in prompt, the Functions tab and the approval prompt follow Mistral's documentation. The write and delete tools were not called, because they change the portal. No record was read by ID, and no owners, lists, property definitions or blog posts were listed. A limit above the maximum was sent to the search tool only.
Le Chat and HubSpot errors and fixes
Messages the vendors document
The first five messages came back in the November 14, 2026 test through the connector. The last one is Mistral's own setup message from its docs.
| Message | What it means | What to do |
|---|---|---|
| limit must be in range [0..200] (actual value: 201) | HubSpot answers Error 400 with category VALIDATION_ERROR. The CRM search returns at most 200 records per page. | Ask for 200 or fewer per page and page on with the after value. |
| There was a problem with the request. | Error 400. HubSpot rejected the search body, here a filter on a property name that does not exist, and did not say which property was wrong. | Ask Le Chat to read the contact property definitions first and use the internal property name. |
| The scope needed for this API call isn't available for public use. | The connector answered not_allowed to a ticket search. The default Ryze AI connection could not search tickets on the test portal. | Stay with contacts, companies and deals through Ryze AI. For tickets use one of HubSpot's own connectors or its remote MCP server. |
| Object not found. objectId is usually positive. | The connector answered not_found for a deal ID of 0. No record has that ID. | Search for the record first and use the id it returns. |
| provider returned text/html (status 404) "Error 404 Not Found" | HubSpot answered with an HTML 404 page for an ID that does not exist, and the read tool, which parses JSON, reported it as not_found. | Check the ID. Search for the contact by email, or list blog posts and use an ID from the list. |
| MCP connection requires additional information or is invalid | Mistral prints this when its setup check fails. | Confirm the address ends in /mcp exactly as given, then click Connect again. |
Other problems
- Add Connector is missing or refused
- Mistral says adding a custom MCP connector is an administrator action. On Free, Pro and Student plans the account owner is the administrator. On a shared account, ask an administrator. An organization admin may also have switched MCP Connectors off for your workspace.
- The connector name is rejected
- Mistral wants a unique name with no spaces or special characters. Use RyzeAI.
- The HubSpot tools do not load
- Open a fresh chat, then click Refresh tools on the Functions tab of the Ryze AI card. If they are still missing, check that the HubSpot card in Ryze AI reads Connected, then remove the connector and add it back. Mistral lists dynamic tool discovery as unsupported for custom connectors; how that affects a platform connected in Ryze AI later was not verified.
- HubSpot refuses the install
- HubSpot errors when an app is installed in an account without access to a required scope, and only a Super Admin or a user with App Marketplace access can install. Whether a portal below the content scope's tiers completes the install was not tested.
- The sign-in does not complete
- Finish the Ryze AI sign-in, choose workspaces and click Allow connection. If the window closed early, click Connect on the connector card again.
- A search comes back empty
- The result is a total of 0. Check the property's internal name, remember that new records may take a few moments to appear in search and that archived records never do.
- Only some properties come back
- HubSpot returns a default set unless you name fields. Ask for the properties you want by name.
- The wrong portal answers
- One portal is the primary and is used unless you name another. Ask Le Chat to use the portal you mean, or change the primary under View on the HubSpot card in Ryze AI.
- Mistral says a subscription is required
- The HubSpot tools work only on an active Ryze AI plan or free trial. Start the trial, then repeat the request.
Terms on this page
- Custom MCP Connector
- What Mistral calls an MCP server that you add by its HTTPS address on the Connectors page.
- MCP
- The Model Context Protocol, an open standard through which AI models reach outside data and apps.
- Portal
- A HubSpot account. Each Ryze AI connection is one portal.
- Scope
- A permission an app asks for at install time. Each one opens a set of HubSpot API endpoints and the data behind them.
- Super Admin and App Marketplace access
- The two HubSpot user permissions that allow installing an app.
- Filter group
- A block of filters in a CRM search. Filters inside a group are joined with AND and groups with OR, up to 5 groups of 6 filters.
- Recycling bin
- Where deleted CRM records go. HubSpot restores them for up to 90 days.
Sources: Mistral docs: MCP connectors, HubSpot scopes reference, HubSpot: install apps from the Marketplace, HubSpot CRM search guide, HubSpot: restore deleted records. Checked November 14, 2026.
Frequently asked questions
How do I connect Le Chat to HubSpot?
Connect HubSpot in Ryze AI under Integrations, then add https://connector.get-ryze.ai/mcp in Mistral Vibe (formerly Le Chat). The path is Connectors, + Add Connector, Custom MCP Connector; enter a name such as RyzeAI and the URL, click Connect and finish the Ryze AI sign-in.
What is the HubSpot MCP server URL for Le Chat?
For the Ryze AI connector it is https://connector.get-ryze.ai/mcp, the same for every user. HubSpot's own remote server sits at https://mcp.hubspot.com; HubSpot's pages do not name Le Chat, and that route was not tried for this guide.
Is there a Le Chat HubSpot connector?
HubSpot lists live connectors for ChatGPT, Claude, Gemini and Microsoft Copilot, and none for Le Chat. Mistral lets an administrator add any remote MCP server by URL as a Custom MCP Connector, and the Ryze AI connector is added that way. Whether Mistral's directory lists a HubSpot connector was not checked.
Does HubSpot's own MCP server work with Le Chat?
HubSpot's setup page asks for a client ID and secret made under Development, MCP Connectors, and an OAuth client with PKCE. Mistral detects OAuth 2.1 with dynamic client registration and shows no client ID or secret field. Neither vendor mentions the other, and the pairing was not tried.
Which HubSpot connector should I use with Le Chat?
Use the Ryze AI connector when you want one address that Mistral can add today for contacts, companies and deals. It has 5 tools and needs a Ryze AI plan or trial. HubSpot's remote server reaches more objects, but HubSpot does not name Le Chat.
Do I need a paid Mistral plan?
Mistral's connector docs name no minimum plan. They say an administrator has to add a custom MCP connector, and on Free, Pro and Student plans the account owner is the administrator. Mistral's pricing page marks Custom MCP connectors, labeled beta, on Free, Pro, Team and Enterprise.
Which HubSpot permission do I need?
Installing the Ryze AI app takes a Super Admin or a user with App Marketplace access. Other users need a Super Admin to approve the install first.
Can Le Chat change my HubSpot data?
Yes. The write tool creates or updates contacts, companies, deals and blog posts, and adds associations. Mistral asks before a call that creates, modifies, sends, posts or deletes, so read the prompt before you click Continue.
Can Le Chat delete HubSpot records?
Yes, through the separate hubspot__delete tool, when you ask for it explicitly. Most CRM deletes go to HubSpot's recycling bin and can be restored for up to 90 days, while a deleted blog post may not be recoverable.
How do I stop Le Chat from running write tools without asking?
Open Connectors, My Connectors, the Ryze AI card and its Functions tab, and leave Always allow off for hubspot__write and hubspot__delete. Mistral advises keeping write functions on manual approval.
Can Le Chat read HubSpot tickets or custom objects?
Not through the default Ryze AI connection. A ticket search was refused with not_allowed in the November 14, 2026 test, and the requested scopes include no custom object scope.
Which sign-in does Mistral use for Ryze AI?
Mistral detects it from the URL. Ryze AI uses OAuth 2.1 with dynamic client registration, so there is no client ID or secret to type. You sign in to Ryze AI, choose workspaces and click Allow connection. HubSpot is linked separately in Ryze AI with its own OAuth sign-in.
Can I use more than one HubSpot portal?
Yes. Several portals can be connected to one Ryze AI workspace under View, Add one more account. One is the primary and is used unless you name another, and each tool takes an optional connection_id.
Why do the HubSpot tools not show up in Le Chat?
Open a new chat first, then click Refresh tools on the Functions tab of the Ryze AI card. If they are still missing, confirm that Ryze AI lists HubSpot as Connected, then remove the connector and add it again.
How much does it cost to connect Le Chat to HubSpot?
Adding the connector is free, and the HubSpot tools need an active Ryze AI plan or trial. Paid Ads is $89 per month with a 7-day free trial, Agency is $279 per month, and annual billing takes 30% off the first year.