How to connect Le Chat to HubSpot

Link a HubSpot portal once in Ryze AI, add one custom MCP connector in Mistral Vibe (formerly Le Chat), then ask about contacts, companies and deals in a chat.

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

Copies the link and opens Mistral Vibe. Then go to Connectors, + Add Connector, Custom MCP Connector. See the steps

See pricing

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.

  1. In Ryze AI open Integrations, click Connect on the HubSpot card, pick the portal and approve the permissions
  2. In Mistral Vibe open Connectors, + Add Connector, then the Custom MCP Connector tab
  3. Enter a name without spaces, such as RyzeAI, and the URL above, then click Connect
  4. Finish the Ryze AI sign-in, choose workspaces, click Allow connection and start a new chat

Le Chat to HubSpot at a glance

FactDetail
Main wayThe Ryze AI connector, added to Mistral Vibe as a Custom MCP Connector
Address to enterhttps://connector.get-ryze.ai/mcp
Sign-inA 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 tools5: 3 that read, 1 that writes and 1 that deletes
Changes to HubSpotYes. 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 chatThe same connector address serves the other platforms connected in your Ryze AI workspace. The HubSpot tools reach one HubSpot portal per connection
Mistral requirementAn administrator adds the connector. On Free, Pro and Student the account owner is the administrator. No minimum plan is named
Ryze AI pricePaid Ads, $89 per month with a 7-day free trial. Adding the connector is free
HubSpot's own optionA 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 testedThe 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.

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

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

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

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

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

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

  1. Open Connectors, then the My Connectors tab.
  2. Open the Ryze AI card and go to its Functions tab.
  3. Switch Always allow on for hubspot__search, hubspot__listObjects and hubspot__read if you want lookups to run without a prompt each time.
  4. Leave Always allow off for hubspot__write and hubspot__delete, so Mistral asks before each one.
  5. 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

TopicWhat Mistral pages say
Product nameVibe. 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 addedThe Connectors page from the sidebar, + Add Connector, Custom MCP Connector tab
PlanThe 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 oneAn administrator, which on Free, Pro and Student is the account owner by default
TransportA remote address over HTTPS with a valid TLS certificate. Mistral shows no field for a local command
Sign-inDetected from the URL: none, a Bearer token or Basic Auth in the Authorization header, or OAuth 2.1 with dynamic client registration
ApprovalA prompt before actions that create, modify, send, post or delete: Continue, Always allow for the session, or Decline
Picking the connectorWork 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 yetDynamic tool discovery, resources and automatic prompt templates
Where it is managedUsers: 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 permissionHubSpot scopeWhat HubSpot says it coversAvailability
Contacts read and writecrm.objects.contacts.read, crm.objects.contacts.writeView properties and details about contacts. Write adds creating, deleting and changing themAll accounts
Companies read and writecrm.objects.companies.read, crm.objects.companies.writeView properties and details about companies. Write adds creating, deleting and changing themAll accounts
Deals read and writecrm.objects.deals.read, crm.objects.deals.writeView properties and details about deals. Write adds creating, deleting and changing themAll accounts
Owners readcrm.objects.owners.readView details about users assigned to a CRM recordAll accounts
Contact schema readcrm.schemas.contacts.readView property settings for contactsAll accounts
Deal schema read and writecrm.schemas.deals.read, crm.schemas.deals.writeView, create, delete or change property settings for dealsAll accounts
Lists readcrm.lists.readView details about contact listsAll accounts
ContentcontentAccess to content APIs, including website pages, landing pages and blog APIsCMS Hub Professional or Enterprise, or Marketing Hub Professional or Enterprise only
Optional: CMS functionscms.functions.read, cms.functions.writeView and write serverless functions and secretsContent Hub Enterprise only
Optional: knowledge basecms.knowledge_base.articles.read and related scopesView knowledge articles through the GraphQL APIService Hub Professional or Enterprise only
Optional: membershipcms.membership.access_groups.read, cms.membership.access_groups.writeView, create, edit and delete membership access groupsService 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.

ToolTypeWhat it does
hubspot__listObjectsReadLists CRM records of one object type page by page, with the properties you choose and the IDs of associated records.
hubspot__searchReadSearches CRM records through the HubSpot CRM Search API with filter groups, sorts, a text query and chosen properties.
hubspot__readReadSends a GET request to a HubSpot JSON API resource, such as a record, property definitions, owners, a list or blog posts.
hubspot__writeWriteCreates or updates a HubSpot resource, such as a contact, company, deal or blog post, and adds associations between records.
hubspot__deleteDeleteDeletes (archives) a HubSpot resource by ID, such as a CRM record or blog post.

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.

LimitNumber
Burst limit for Marketplace OAuth apps110 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 rate5 requests per second per account. Search responses carry none of the rate limit headers
Search page size10 records by default, 200 at most. The connector refused a limit of 201 with limit must be in range [0..200]
Listing page sizehubspot__listObjects accepts a limit up to 100. HubSpot's contacts guide gives 100 per list request
Search result cap10,000 results in total for any query. Paging past 10,000 returns a 400 error
Search filtersAt 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 length3,000 characters at most in a request body
Default propertiesA search returns a fixed set unless you name properties. Contacts: firstname, lastname, email, lastmodifieddate, hs_object_id, createdate
Batch sizeBatch operations are limited to 100 records at a time
Path length in Ryze AI tools2,048 characters at most for the path argument of read, write and delete
Access token lifeOAuth access tokens expire after 30 minutes, and the app refreshes them with a refresh token
Past the limitHubSpot answers 429. The daily limit resets at midnight in the account's time zone
Search delayNew or updated records may take a few moments to appear in search. Archived records never appear
Recycling binDeleted records can be restored up to 90 days after deletion. Permanent or GDPR deletions skip the bin
HubSpot's own connectorsThe 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 MistralUnique, 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.

JobAsk Le ChatToolWorks on the default connection
Contact lookupFind a contact by email and show the properties I name.hubspot__searchYes. A contacts search was run
Recent dealsList deals created in the last 30 days with name, amount and stage.hubspot__searchYes. A deals search was run
Stale dealsFind open deals with no change in 30 days and show the owner of each.hubspot__search, then hubspot__read on the owners pathYes. The owners read was not run
Company and its recordsFind a company by domain and list its associated contacts and deals.hubspot__search, then hubspot__listObjects with associationsYes. A companies search was run; associations were not requested
Contact pagingPage through contacts with lifecycle stage and create date.hubspot__listObjectsYes. Listing with a limit of 1 returned a paging cursor
Property inventoryShow which contact and deal properties exist before I build a filter.hubspot__read on the properties pathsYes. Not run
List detailsRead a contact list and its details.hubspot__read on the lists pathYes. Read only, and not run
New dealCreate a deal and associate it with a company and a contact.hubspot__writeYes. Not run, because it changes the portal
Property updateUpdate one property on a contact, company or deal.hubspot__writeYes. Not run
Duplicate cleanupDelete the duplicate contact I name by ID.hubspot__deleteYes. 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.

WayRuns whereSetup in Mistral VibeWhat it reaches in HubSpotPrice
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 clientsAn 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 OAuth5 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 objectsPaid Ads $89 per month, 7-day free trial. Adding the connector is free
HubSpot's remote MCP serverHosted by HubSpot at https://mcp.hubspot.comIn 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 Chat36 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 toolNo price stated on the pages read
ComposioHostedA 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 ChatGPT354 tools and 2 triggers on the toolkit page, read and write, including batch create, update and archivePricing 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 MCPHostedAdd 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 themThe HubSpot actions you enable from your Zapier account. Zapier prints no total for HubSpotNo separate MCP price. Each successful tool call uses 2 tasks from your Zapier plan
Windsor.ai (Windsor MCP)HostedConnect 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 ChatReporting access to HubSpot data, 1,141 fields on the connector page. The pages do not show write actions for HubSpotWindsor 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

DateWhat happened
September 1, 2025HubSpot's remote MCP server went into public beta across all hubs and tiers.
September 2, 2025Le Chat gained custom MCP connectors and a directory of more than 20 connectors (beta), open to every user, Free plan included.
April 13, 2026HubSpot'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, 2026Le Chat became Vibe at chat.mistral.ai, and Mistral's docs moved from /le-chat to /vibe.
June 24, 2026Mistral added per-workspace and per-tool connector controls for admins, connectors that hold several logins, and the Connectors Debugger.
August 27, 2026HubSpot 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, 2026HubSpot 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, 2026HubSpot 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, 2026Chat and Work merged into one Vibe experience. Enterprise organizations move from October 1, 2026, within about six months.
October 30, 2026HubSpot 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, 2026HubSpot'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 runWhat 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 dealsThree searches with a filter that could not match returned the valid empty shape {"total":0,"results":[]}.
Listing contactsA 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 purposeA 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 existReads 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.

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

Connect HubSpot to Le Chat

Connecting is free. The HubSpot tools need a Ryze AI plan or trial. Paid Ads is $89 per month with a 7-day free trial; annual billing takes 30% off the first year.

HubSpot MCP server

Need help? Read the Ryze AI HubSpot guide or email Ryze AI support.