How to connect Perplexity to HubSpot

Connect HubSpot once in Ryze AI with HubSpot's own sign-in, add one remote MCP connector in Perplexity, then ask about contacts, companies and deals in a thread.

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

Copies the link and opens Perplexity. Then go to Plugins, Add custom, Add MCP connector. See the steps

See pricing

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

Quick answer

The main way to connect Perplexity to HubSpot is the Ryze AI connector. Approve HubSpot inside a Ryze AI workspace through HubSpot's own sign-in, then on Perplexity's Plugins page choose Add custom, Add MCP connector, Remote, enter https://connector.get-ryze.ai/mcp, pick OAuth with Streamable HTTP and Public network access, and open the connector card to sign in.

  1. In Ryze AI open Integrations, click Connect on HubSpot, sign in, choose the account and approve the permissions
  2. In Perplexity open Plugins, Add custom, Add MCP connector, Remote, and enter the name and URL
  3. Set Authentication to OAuth, tick the acknowledgement and click Add
  4. Select the connector card to sign in to Ryze AI and enable it, then start a new thread

Perplexity to HubSpot at a glance

QuestionAnswer
Main way to connectThe Ryze AI connector, which Perplexity takes as a custom remote connector on its Plugins page
What goes in the MCP server URL fieldhttps://connector.get-ryze.ai/mcp, with Transport set to Streamable HTTP
Sign-inTwo OAuth approvals: HubSpot's consent screen inside Ryze AI, then the Ryze AI screen opened from the Perplexity card. Perplexity registers itself, so Client ID and Client Secret stay empty
HubSpot tools5. hubspot__search, hubspot__listObjects and hubspot__read fetch data, hubspot__write creates and updates, hubspot__delete archives
HubSpot objects in reachContacts, companies and deals with their associations, contact lists and owners to read, and CMS blog content. Tickets and custom objects are outside it
Can it change HubSpotYes, through hubspot__write and hubspot__delete. Perplexity says it asks you to approve consequential writes
Perplexity planPro, Max or Enterprise. In an Enterprise organization, the Allow members to add custom connectors toggle must be on
Who in HubSpot can connectA Super Admin, or a user with App Marketplace access
Ryze AI priceAdding the connector is free. The tools need a plan or trial, such as Paid Ads at $89 per month with a 7-day free trial
HubSpot's own option for PerplexityNone named. HubSpot's ready-made connectors serve ChatGPT, Claude, Gemini and Microsoft Copilot. Its remote MCP server is open to MCP clients with OAuth and PKCE, and its pages do not name Perplexity
Last testedConnector sign-in details on November 13, 2026, and 11 read-only HubSpot calls from Claude Code on November 14, 2026. Nothing was run inside Perplexity

Before you start

  • A Perplexity plan that allows custom connectors. Perplexity's March 2026 changelog says Pro, Max and Enterprise subscribers can add a custom remote connector by MCP server URL, and its connector troubleshooting article names the same three plans. In an Enterprise organization, members can add one for their own account only if an administrator turns on Allow members to add custom connectors (off by default). Only administrators can add organization-wide connectors.
  • Super Admin or App Marketplace Access in HubSpot. HubSpot lets Super Admins and users with App Marketplace Access permissions install apps from the HubSpot Marketplace and third-party websites. Other users need a Super Admin to approve first.
  • A Ryze AI workspace on a plan or free trial. Paid Ads is $89 per month with a 7-day free trial, and annual billing takes 30% off the first year. Connecting the connector is free; the HubSpot tools need an active plan or trial. Content Plan publishing to a HubSpot blog sits with SEO Starter at $129 per month with a 3-day free trial.
  • Trust in the server. Perplexity's help center says to use only connectors from sources you trust, because Perplexity cannot verify third-party MCP servers. Check who runs a server before you add it.

How to connect Perplexity to HubSpot

Setup has two parts. HubSpot is connected inside Ryze AI with HubSpot's own sign-in, then Perplexity is pointed at the Ryze AI connector. The Perplexity steps follow its help center for your own account. Ryze AI sign-in was not tested inside Perplexity while this page was written, so use the troubleshooting list below if a step differs on your screen.

  1. Connect HubSpot in Ryze AI

    Sign in to Ryze AI (or create an account), 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 login you want the connector to use. If it has access to more than one HubSpot account (portal), pick one 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 returns you to Ryze AI with the connection saved. Optional for blog publishing: click View on the HubSpot card, pick the Blog and the Author, and click Save.

    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. Open Plugins in Perplexity

    Open Plugins in the sidebar. If Plugins is not shown, open Customize, then Connectors.

  5. Add a remote MCP connector

    Select Add custom, then Add MCP connector, and choose Remote. Enter the name Ryze AI and the MCP server URL https://connector.get-ryze.ai/mcp.

  6. Set the advanced options

    Under Advanced set Authentication to OAuth, Transport to Streamable HTTP and Network access to Public. Perplexity documents a default for Network access only, so look at the other two before you go on. Ryze AI supports dynamic client registration, so you enter no client ID or secret. Do not pick API Key: the form has no field for custom headers, and HubSpot signs in through Ryze AI instead.

  7. Add the connector and sign in

    Select the acknowledgement checkbox, then select Add. Select the connector card on the Plugins page to start the Ryze AI sign-in, choose the workspace that holds your HubSpot connection and enable the connector. Then start a new thread. A card that fails Perplexity's server check carries an error tag; correct the URL, transport or authentication and reconfigure it.

Sources: Perplexity help: adding custom remote connectors, Perplexity changelog, March 12, 2026. The Ryze AI HubSpot guide covers the HubSpot sign-in on the Ryze AI side. Checked November 14, 2026.

Enterprise organization setup

An Enterprise administrator can add the connector for the whole organization instead of each member adding it:

  1. Open Organization settings, then Connectors, and select Custom connector.
  2. Enter the name and URL, set the advanced options as above, select the acknowledgement checkbox and select Add.
  3. New organization connectors start turned off. Turn the connector on in Organization settings, then Connectors.
  4. Choose whether to authenticate once for the organization or require each member to sign in. The HubSpot connection sits in the Ryze AI workspace, so everyone who reaches that workspace through the connector works through the same HubSpot connection and its scopes.

Perplexity's help center also describes a Cloudflare Access network option and AWS PrivateLink for Enterprise. The Ryze AI connector is a public URL, so Public is the setting to use. On sales-assisted Enterprise plans, switching a connector on can open a dialog that asks which roles may use it; Perplexity's article on that dialog does not single out custom connectors.

Sources: Perplexity help: adding custom remote connectors, Perplexity help: role-based access for connectors. Checked November 14, 2026.

Local MCP and other surfaces

Local MCP servers and the Mac app

Servers that Perplexity starts from a command on your own machine need its desktop software: the Mac app, or Portable Computer on supported hardware. The web app accepts remote addresses only. The Ryze AI connector is a remote server, so it uses the Plugins flow above and needs no local helper. A remote connector connected anywhere is connected for the account everywhere, including inside plugins.

Other Perplexity surfaces

This guide covers the web flow in Perplexity and the Enterprise organization flow. Perplexity's blog says a connected MCP server can be used in answers and in Perplexity Computer workflows. A connector you authorize in a personal account does not follow you into an Enterprise workspace or a Project, and Perplexity's pages do not say whether Add MCP connector is offered in the mobile apps. Ryze AI documents no other Perplexity surface, so this page gives no steps for them.

Perplexity and MCP: the facts in one table

TopicWhat Perplexity's own pages say
Where you add a serverPlugins in the sidebar, then Add custom, Add MCP connector and Remote. Accounts that still show Customize use Customize, Connectors
Organization-wide serversOrganization settings, Connectors, Custom connector in the top-right corner. Administrators only, and a new one starts switched off
Fields on the formA name of up to 64 characters and an https:// server URL are required. A description and an icon of up to 128 KB are optional
Transport choicesStreamable HTTP or SSE for remote servers. Command-started (stdio) servers run only in desktop software
Authentication choicesOAuth, API Key or None. With OAuth, Perplexity can detect endpoints and scopes from /.well-known/oauth-authorization-server when the server offers that file, and registers itself where the server allows dynamic client registration
Redirect URLhttps://www.perplexity.ai/rest/connections/oauth_callback, needed only for an OAuth server without dynamic client registration
Custom headersNo field for them. The two Cloudflare Access service-token headers are the only exception
Approval before changesAn approval card before consequential writes. Since August 24, 2026 a connector tool can be set to Always ask; Perplexity does not say whether custom connectors show that setting
PlanPro, Max and Enterprise, per the March 2026 changelog, the connector troubleshooting article and an October 14, 2026 blog post. The custom connectors article names no plan
Managing it laterPlugins, Installed tab: status, Reconnect and Disconnect. Disconnecting and connecting again loads a changed tool list
What blocks or steers a callA Focus or Sources setting of Web-only, Academic or Social. Naming the connector, the connector picker or an @ mention points Perplexity at it

Sources: Perplexity help: local and remote MCPs, Portable Computer, troubleshooting connectors, find, install and remove plugins, Perplexity changelog, August 24, 2026, Perplexity blog on MCP tools. Checked November 14, 2026.

HubSpot access and scopes

Perplexity reaches HubSpot through two separate logins: HubSpot's OAuth sign-in inside Ryze AI, and the Ryze AI sign-in from Perplexity. Three things decide what the thread can see.

Who can connect
A HubSpot Super Admin or a user with App Marketplace Access. Anyone else needs a Super Admin to approve the install first.
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 with Add one more account. The starred account is the primary and is used unless you name another.
What the token covers
HubSpot's OAuth guide says an access token carries the scopes the app requested and does not follow the installing user's own record limits. A user who may view only their own contacts still hands the app a token that sees every contact once crm.objects.contacts.read is granted. Every Perplexity thread that uses the connector works with that full reach.
Perplexity connector settings
Remote connectors in Perplexity take OAuth, API Key or None. Choose OAuth for Ryze AI. Perplexity's help center says the MCP server behind a custom connector decides what it can reach. In an Enterprise organization an administrator controls who may add connectors and whether sign-in is shared or per member.

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.

Scopes behind each action

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 scope entries that match the Ryze AI access

The Ryze AI facts describe the HubSpot access in words: eight required groups, and four optional ones by name. Each row below takes the matching entry from HubSpot's scope reference, what HubSpot says it opens, and which HubSpot accounts can grant it. The consent screen during the install shows the exact strings. Separately, the Ryze AI listing in the HubSpot Marketplace names eight shared data types: contacts, contact properties, companies, deals, deal properties, contact lists, owners and CMS blog posts.

Scope entry in HubSpot's referenceWhat it opens, per HubSpotRequired or optional, and which accounts can grant it
crm.objects.contacts.read, crm.objects.contacts.writeContact properties and details; creating, deleting and changing contactsRequired. Open to all HubSpot accounts
crm.objects.companies.read, crm.objects.companies.writeCompany properties and details; creating, deleting and changing companiesRequired. Open to all HubSpot accounts
crm.objects.deals.read, crm.objects.deals.writeDeal properties and details; creating, deleting and changing dealsRequired. Open to all HubSpot accounts
crm.objects.owners.readDetails about the users assigned to a CRM recordRequired. Open to all HubSpot accounts
crm.schemas.contacts.readProperty settings for contactsRequired. Open to all HubSpot accounts
crm.schemas.deals.read, crm.schemas.deals.writeViewing and changing property settings for dealsRequired. Open to all HubSpot accounts
crm.lists.readDetails about contact listsRequired. Open to all HubSpot accounts
contentContent APIs: website pages, landing pages and blogs among themRequired. Only CMS Hub or Marketing Hub, Professional or Enterprise
filesThe file manager, through a legacy scope HubSpot asks existing apps to swap for granular ones such as files.readOptional. Open to all HubSpot accounts
cms.functions.read, cms.functions.writeContent Hub serverless functions and secretsOptional. Only Content Hub Enterprise
cms.knowledge_base.articles.read and related entriesKnowledge articles through the GraphQL APIOptional. Only Service Hub Professional or Enterprise
cms.membership.access_groups.read, cms.membership.access_groups.writeMembership access groups: view, create, edit and deleteOptional. Only Service Hub or Content Hub, Professional or Enterprise

HubSpot handles the two kinds differently at install time. A required scope the chosen portal cannot grant stops the install with an error, while an optional scope the portal lacks is dropped from the request automatically. Whether a portal without CMS Hub or Marketing Hub at Professional or Enterprise can finish the Ryze AI install, given the content scope, was not tested for this guide.

Left out of the list: tickets, custom objects (HubSpot lists crm.objects.custom.read and crm.objects.custom.write as Enterprise-only), list editing (crm.lists.write), company property settings (crm.schemas.companies.read) and the separate Sensitive Data scopes. A ticket search sent through Ryze AI on November 14, 2026 was refused, so plan on contacts, companies and deals when you work from Perplexity.

Sources: HubSpot's scope reference, working with OAuth, installing apps, the Ryze AI Marketplace listing and HubSpot connector permissions. Checked November 14, 2026.

Removing access

To remove access, click View on the HubSpot card in Ryze AI and disconnect the portal with the trash icon, uninstall the app in HubSpot (Settings, Integrations, Connected Apps, Actions, Uninstall, then type uninstall), or remove the Ryze AI connector in Perplexity under Plugins.

What Perplexity can do in HubSpot

The Ryze AI connector gives Perplexity 5 HubSpot tools: 3 that read, 1 that writes and 1 that deletes. Each runs as the HubSpot account you connected, and each accepts an optional connection_id when a request should go to a portal other than the primary one.

ToolTypeWhat it does
hubspot__readReadSends a GET request to any HubSpot JSON API resource, such as a record, property definitions, owners, a list or blog posts.
hubspot__searchReadSearches CRM records through the HubSpot CRM Search API with filter groups, sorts, a text query and chosen properties.
hubspot__listObjectsReadLists CRM records of one object type page by page, with the properties you choose and the IDs of associated records.
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. Most CRM deletes go to HubSpot's recycling bin; deleted blog posts may not be recoverable.

Perplexity's connector troubleshooting article says it asks you to approve consequential writes before they run. It does not list which calls count, so treat every hubspot__write and hubspot__delete request as one to read twice, and name the exact record. Perplexity's August 24, 2026 changelog adds an Always ask setting for connector tools, where you approve one action, allow the tool for the rest of the thread or deny it; whether a custom connector offers that setting is not stated. The Ryze AI chat has its own Tool approvals setting, which starts on Skip all approvals; switch it to Approve write & delete or Manual approve if you want a check there. Scheduled tasks in Ryze AI run without an approval step.

HubSpot and Perplexity limits in numbers

Most of these numbers are HubSpot's, each in HubSpot's own unit. The Ryze AI tool definitions add caps on list size and path length. Perplexity's pages print no cap on the number of custom connectors or tools, and no timeout or size limit for a tool call.

LimitNumberSource
Records per search page10 if the request names no limit, 200 at most. A request for 201 was refused in the November 14 testHubSpot CRM search guide
Records one search can reach10,000 in total. Paging beyond that returns a 400 errorHubSpot CRM search guide
Filters in one searchUp to 5 filter groups with up to 6 filters each, 18 filters at most overallHubSpot CRM search guide
Search request size3,000 characters. A longer request body gets a 400 errorHubSpot CRM search guide
Search speed5 requests per second for each HubSpot account, with no rate limit headers on search responsesHubSpot CRM search guide, usage guidelines
Records per hubspot__listObjects call100, the tool's own cap. HubSpot also returns at most 100 contacts in one list requestRyze AI tool definition, HubSpot contacts guide
Path length in read, write and delete2,048 charactersRyze AI tool definitions
Blog posts per page20 unless the request asks for another numberHubSpot blog posts guide
Segments (lists) per page20 by default, 500 at mostHubSpot lists guide
Burst limit for Marketplace OAuth apps110 requests every 10 seconds for each account that installs the app, searches not counted. Past a limit HubSpot answers 429. Ryze AI uses OAuth and has a Marketplace listing, but HubSpot's page does not name Ryze AI and no test response carried a rate limit headerHubSpot usage guidelines
Access token lifetime30 minutes. The app then uses its refresh token for a new oneHubSpot OAuth tokens
Recycling binDeleted CRM records can be restored for up to 90 daysHubSpot knowledge base
Connector name and icon in Perplexity64 characters for the name, 128 KB for the iconPerplexity help: custom remote connectors
Servers in one custom Perplexity plugin15 MCP servers. Any past the fifteenth are skippedPerplexity help: plugins

Every source in the table was checked November 14, 2026.

The 11 HubSpot calls behind this guide

These 11 calls ran on November 14, 2026, at about 15:40 UTC. They went from Claude Code through the Ryze AI connector to a HubSpot portal on the default connection. Search values were random strings and the IDs were made up, so no record from that portal appears below. Every call was a read.

CallWhat was sentWhat came back
Contact searchhubspot__search on contacts: email EQ a string of 20 random lettersSuccess with no matches: {"total":0,"results":[]}
Company searchhubspot__search on companies: domain EQ a string of 20 random lettersSuccess with no matches, in the same empty shape
Deal searchhubspot__search on deals: dealname EQ a string of 20 random lettersSuccess with no matches, in the same empty shape
Contact listinghubspot__listObjects on contacts: limit 1, property hs_object_idSuccess: one result holding id, properties, createdAt, updatedAt, archived and url, plus paging.next with after and link. HubSpot also sent createdate and lastmodifieddate unasked
Search on an unknown propertyhubspot__search on contacts, filtering on a property name HubSpot does not haveError 400 from HubSpot
Oversized pagehubspot__search on contacts: limit 201 and a filter that cannot matchError 400 with the category VALIDATION_ERROR
Ticket searchhubspot__search on tickets with a filter that cannot matchRefused with the status not_allowed
Deal number 0hubspot__read of crm/v3/objects/deals/0The status not_found
Contact with a made-up IDhubspot__read of crm/v3/objects/contacts/ plus an 18-digit IDThe status not_found. HubSpot replied with an HTML 404 page
Blog post with a made-up IDhubspot__read of cms/v3/blogs/posts/ plus an 18-digit IDThe status not_found, with the same HTML 404 form
Blog post number 1hubspot__read of cms/v3/blogs/posts/1The status not_found again. Neither blog call shows whether blog reads work on that portal

First 3 prompts to run

The prompts below describe what each one asks for. Answers come from your own HubSpot account, so this page shows no sample numbers. HubSpot returns a default subset of properties unless you name the fields, so list the properties you want.

1. Review open deals by owner

Using the Ryze AI connector, search my HubSpot deals created in the last 30 days and list deal name, amount and stage, then look up the owner of each deal and group the list by owner.

Tools used: hubspot__search, hubspot__read (owners)

What comes back: Deals grouped by owner with the properties you named. Deals without an owner appear in their own group.

2. Find contacts missing a field

Using the Ryze AI connector, list HubSpot contacts created this month with first name, last name, email and lifecycle stage, and point out the contacts that have an empty lifecycle stage.

Tools used: hubspot__listObjects or hubspot__search

What comes back: A table of contacts with the four properties and a short list of the ones with the empty field. Nothing is changed.

3. Check a company and its deals

Using the Ryze AI connector, find the HubSpot company with the domain I name, show its key properties and list the deals associated with it with amount and stage.

Tools used: hubspot__search, hubspot__listObjects with associations

What comes back: The company record and its associated deals, read from the connected portal. Ask for an edit only after you read the result, and name the exact record.

Start with read prompts. Once you trust the setup, you can ask for changes such as updating a deal stage, and name the record so the request is specific.

10 HubSpot jobs to hand to Perplexity

Ten requests to type into a Perplexity thread, each paired with the HubSpot tool it calls. Perplexity's help center suggests naming the connector, so each one starts that way. The November 14, 2026 test ran searches, one contact listing and reads of IDs that do not exist; owner, property and list reads, writes and deletes were not run.

JobAsk PerplexityToolOn the default connection
Contact lookupWith Ryze AI, find the HubSpot contact whose email I paste and show the properties I list.hubspot__searchYes
Stalled dealsWith Ryze AI, find open deals with no change in 30 days and tell me who owns each one.hubspot__search, then hubspot__read on crm/v3/ownersYes
Company and its linksWith Ryze AI, find the company with the domain I give and list its associated contacts and deals.hubspot__search, then hubspot__listObjects with associationsYes
Contacts in pagesWith Ryze AI, page through my contacts and show lifecycle stage and create date for each.hubspot__listObjectsYes
Property namesWith Ryze AI, which contact and deal properties exist in my portal, by internal name?hubspot__read on crm/v3/properties/contacts and crm/v3/properties/dealsYes
List detailsWith Ryze AI, read the contact list with the ID I give and describe it.hubspot__read on crm/v3/lists/{listId}Yes, to read. Adding or removing members is not supported
New dealWith Ryze AI, create a deal with the name and amount I give and associate it with this company and contact.hubspot__writeYes. It changes the portal
One field updateWith Ryze AI, move the deal I name to the stage I give, then read the deal back.hubspot__write (method UPDATE), then hubspot__readYes. It changes the portal
Duplicate cleanupWith Ryze AI, delete the duplicate contact with the ID I give.hubspot__deleteYes. Most CRM deletes go to the recycling bin, restorable for up to 90 days
Ticket reviewWith Ryze AI, show my open support tickets.hubspot__searchNo. The test search on tickets was refused

3 ways to connect Perplexity to HubSpot

Three ways bring HubSpot data into Perplexity today. The Ryze AI connector is the main way in this guide: Perplexity's help center documents a form that takes its address with OAuth and no client ID, HubSpot is approved once inside Ryze AI, and its 5 tools both read and change CRM records. Windsor.ai and Coupler.io name Perplexity on their own pages, read on November 14, 2026; neither was set up for this guide. The HubSpot options and services that leave Perplexity off their lists follow the table.

WayRuns whereSetup in PerplexityWhat it reaches in HubSpotPrice
Ryze AI connector (the main way)Hosted by Ryze AI. The same address also serves Claude, ChatGPT and other MCP clientsOn the web: Plugins, Add custom, Add MCP connector, Remote; the address with OAuth and Streamable HTTP; Add, then open the card and sign inContacts, companies and deals to read, create, update and delete, with associations; contact lists and owners to read; CMS blog content. Several portals per workspaceFree to add. The tools run on a Ryze AI plan or trial; Paid Ads costs $89 a month after a 7-day free trial
Windsor.ai (Windsor MCP)HostedAdd HubSpot as a data source in Windsor.ai, then follow the setup guide Windsor's MCP page names for the Perplexity desktop appReporting across 1,141 HubSpot fields (287 metrics, 854 dimensions): list sources and accounts, look up field names, fetch data for a date range. Windsor's page names write actions for Google Ads and Meta Ads and does not list HubSpot among themWindsor MCP comes with every plan. Free forever: 1 user, 1 data source, 1 account. Basic $23 a month, or $19 a month billed annually, for 3 sources
Coupler.io MCPHostedBuild a Coupler.io data flow that loads HubSpot, then open its MCP Server page and follow the steps there. Access uses a personal access token from the Coupler.io web app. Its pricing page lists Perplexity among the AI integrationsRead-only analysis of the HubSpot data your flows load, such as contacts, companies, deals, tickets, owners, products and reports. Coupler.io says the AI gets aggregated data and no individual recordsFree; Starter $32 a month ($24 billed annually); Active $132 ($99); Pro $259 ($199). Its HubSpot page and pricing page disagree on which plan includes MCP

HubSpot options and services that do not list Perplexity

  • HubSpot's remote MCP server at https://mcp.hubspot.com, the one HubSpot builds for people creating their own agents and the base of its own connectors. You create an MCP connector in HubSpot under Development, MCP Connectors with a redirect URL, and HubSpot generates a client ID and secret; OAuth with PKCE is required. Its 36 documented tools read CRM records including tickets and custom objects, activities, blog posts, landing pages, campaigns, conversations, social posts and content analytics, and create or edit records, activities, pages, blog posts, campaigns, segments, social posts and custom properties; none deletes. With Sensitive Data turned on in the account, conversation data is blocked through it. HubSpot's setup page says any MCP client that supports OAuth with PKCE can connect, and names Claude, ChatGPT and Gemini as the select clients that get three content tools. Perplexity is not named. Perplexity's form takes a client ID, a secret and its redirect URL for servers without dynamic client registration, but its pages do not mention PKCE, and this pairing was not tried for this guide.
  • HubSpot's ready-made connectors. HubSpot's AI tools page names live connectors for ChatGPT, Claude, Gemini and Microsoft Copilot. Each lives inside that assistant, and none is offered for Perplexity.
  • HubSpot's local and command-line tools. The Developer MCP server lists Claude Code, Codex CLI, Cursor, Gemini CLI, VS Code and Windsurf, and is built for apps and CMS assets, with no CRM record tools. The older @hubspot/mcp-server beta covers Claude Desktop and Cursor in its README and needs a private app token, while HubSpot stopped older accounts from creating new legacy private apps from October 26, 2026. The Agent CLI beta names Claude Code, Claude Cowork, OpenAI Codex, the ChatGPT and Claude apps, Cursor and Windsurf. HubSpot's plugins target Claude Code and the Claude desktop app. Perplexity's Mac app can start local servers, but none of these pages lists Perplexity.
  • Composio and Zapier MCP. Composio's HubSpot toolkit page (354 tools and 2 triggers) offers its hosted server for Claude, Cursor and ChatGPT and does not name Perplexity. Zapier's quickstart names Claude, Claude Code, ChatGPT, Cursor and Codex as popular clients, plus Gemini Enterprise, Grok, VS Code and Windsurf among others, and Perplexity is not in that list.
  • baryhuang/mcp-hubspot, an open-source Docker server with 7 tools for contacts, companies and engagement data (129 GitHub stars and a last push on November 11, 2025, as of November 14, 2026). Its README gives setup steps for Claude's desktop app only.

Which one to pick

Ryze AI is the best way to connect Perplexity to HubSpot when you want to read and change contacts, companies and deals from a Perplexity thread through one address you add on Perplexity's own form with OAuth, with two caveats: tickets, custom objects, list edits and HubSpot's wider content types sit outside its 5 tools, and the tools need a Ryze AI plan or trial. Windsor.ai fits reporting on HubSpot fields over a date range, and Coupler.io fits read-only analysis of HubSpot data it loads for you; both list Perplexity. If your team also works in ChatGPT or Claude, HubSpot's own connector there reaches tickets and more object types without a Ryze AI account; its Gemini connector reads contacts, companies and deals only.

Sources: HubSpot remote MCP server docs, HubSpot AI tools, HubSpot Developer MCP setup, HubSpot Agent CLI guide, Agent CLI article, Agent CLI skills, HubSpot plugins for Claude Code, legacy private app sunset, @hubspot/mcp-server on npm, HubSpot connector for Claude, Windsor MCP, Windsor.ai pricing, Coupler.io HubSpot MCP, Coupler.io pricing, Composio HubSpot toolkit, Zapier MCP quickstart, baryhuang/mcp-hubspot, Ryze AI HubSpot guide. Checked November 14, 2026.

HubSpot and Perplexity: dates that matter

DateWhat happened or is scheduled
May 6, 2025HubSpot released an MCP server as a public beta: the npm package @hubspot/mcp-server, run locally with a private app access token.
September 1, 2025The remote HubSpot MCP server opened its first public beta across all hubs and tiers.
January 13, 2026Self-service MCP auth apps for the remote server went live in public beta, so accounts could create their own (announced January 20).
March 12, 2026Perplexity's Bring Your Own Connector release let Pro, Max and Enterprise subscribers add a remote MCP server by URL, with OAuth, API key or open authentication.
April 13, 2026The remote HubSpot MCP server reached general availability for every HubSpot account, gained write access and made OAuth 2.1 with PKCE mandatory.
August 24, 2026Perplexity added an Always ask setting for connector tools.
August 27, 2026HubSpot announced the end of new legacy private apps: blocked from September 28, 2026 for new accounts and from October 26, 2026 for older ones. Service Keys replace them.
September 15, 2026HubSpot's Fall 2026 Spotlight added custom objects, Leads and read-only conversations to its MCP server and Claude connector. The same day HubSpot announced the end of support for API versions v1 to v3, enforced in September 2027.
October 19, 2026Perplexity let sales-assisted Enterprise administrators choose which roles may use each connector.
October 30, 2026HubSpot opened Sensitive Data access for its AI connectors in public beta, when a Super Admin allows it. Its remote MCP server reads Sensitive Data engagements only.
November 6, 2026Perplexity's changelog announced Agent Plugins, the page where connectors and skills now install.
December 4, 2026HubSpot's Pipelines API V1 is due to be switched off.
March 30, 2027HubSpot ends support for API version v4, per its September 15, 2026 post.

Sources: HubSpot changelog posts on the MCP server beta, self-service MCP auth apps, general availability, legacy private apps, Fall 2026 Spotlight, API version support, October 2026 rollup and Pipelines API V1; Perplexity changelog entries of March 12, August 24, October 19 and November 6, 2026. Checked November 14, 2026.

How this guide was tested

Two runs stand behind this page, and neither took place inside Perplexity. On November 13, 2026, at about 04:20 UTC, the connector's address and sign-in details were checked without signing in. On November 14, 2026, 11 read-only calls reached a HubSpot portal through the connector.

RunResult
Request to the connector with no 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.
The two OAuth discovery files (November 13)Both loaded from the connector's host. They list the authorize, token and register endpoints, the authorization code and refresh token grants, PKCE with S256, and the scopes mcp:read and mcp:write. The register endpoint serves dynamic client registration. Perplexity's help center asks for a Client ID and Client Secret only when a server lacks it, so both stay empty here.
HubSpot tool definitions (November 14)All 5 loaded by name through the connector and match the tools table above. They name three object types: contacts, companies and deals.
Reads that worked (November 14)Three searches, on contacts, companies and deals, gave valid empty results. A contact listing with limit 1 gave one record and a paging cursor.
Reads that were refused or found nothing (November 14)Seven: two searches with bad input, one ticket search and four reads of IDs that do not exist. Their messages are in the errors table below.

Not run for this page: anything inside Perplexity. No connector was added on a Plugins page, no Ryze AI sign-in was completed from a Perplexity card, and no thread called a HubSpot tool, so the Perplexity steps follow Perplexity's help center as read on November 14, 2026. The HubSpot calls went out from Claude Code, which reaches the same server and the same 5 tools. hubspot__write and hubspot__delete were not called, because they change the portal. No existing record was read by its ID, and owners, lists, property definitions and blog posts were not listed. Windsor.ai, Coupler.io and HubSpot's remote server were not tried.

Errors and fixes

Exact messages from the HubSpot calls

Five messages came back in the November 14, 2026 calls. They are copied as returned to Claude Code, except that IDs and trace values are cut. No Perplexity thread was run, so how Perplexity shows them is not known. If one comes back after a HubSpot call, here is what it means and what to ask for next.

MessageWhat it meansWhat to do
limit must be in range [0..200] (actual value: 201)Error 400 with the category VALIDATION_ERROR. A CRM search hands back 200 records per page at most.Ask for 200 or fewer per page, then continue from the after value in the reply.
There was a problem with the request.Error 400 for a search filter on a property HubSpot does not have. The message leaves out which one.Have Perplexity read crm/v3/properties/contacts first and filter on the internal property name it finds there.
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 out of this connector and ask about contacts, companies or deals. HubSpot's own remote server covers tickets, and its pages do not name Perplexity.
Object not found. objectId is usually positive.The status not_found for a deal read with ID 0. No record carries that ID.Search for the deal by name 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. For an ID that does not exist, HubSpot sent an HTML page instead of JSON, and the read tool, which parses JSON only, reports the 404. Two blog post reads with made-up IDs gave the same form. The full message ends with a trace value, cut here.Check the ID. Look the contact up by email, or list the blog posts and take an ID from that list.

Other problems

Add MCP connector is missing in Perplexity
Check your plan. Perplexity's changelog names Pro, Max and Enterprise for custom remote connectors. In an Enterprise organization, ask an administrator to turn on Allow members to add custom connectors, or to add the connector for the organization.
HubSpot shows an error during the install
Your HubSpot user is probably not a Super Admin and lacks App Marketplace Access. 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, add the right portal with Add one more account, then remove the wrong one with the trash icon.
The HubSpot connection stopped working
The token may have been revoked, for example after someone uninstalled the app in HubSpot. Reconnect HubSpot from its card in Ryze AI and authorize again.
A field is missing from the results
HubSpot returns a default subset of properties unless the request names others. Ask for the exact properties you need.
Sign-in fails with API Key selected
Use OAuth. The Perplexity form has no field for custom request headers, and its documentation does not say which header the API Key option sends.
Perplexity asks for a client ID and secret
Perplexity asks for them only for OAuth servers without dynamic client registration. Ryze AI supports dynamic client registration, so leave them empty. If a server needs a redirect URL, Perplexity's is https://www.perplexity.ai/rest/connections/oauth_callback.
HubSpot tools do not appear in Perplexity
If HubSpot was connected in Ryze AI after you added the connector, remove the Ryze AI connector under Plugins, add it again and start a new thread. Perplexity's own advice for a tool list that has changed is to Disconnect and Connect again.
Perplexity answers from the web and never calls HubSpot
Perplexity skips connected apps when Focus or Sources is set to Web-only, Academic or Social. Change that setting, and name the Ryze AI connector in the request or pick it with an @ mention.
Perplexity says a subscription is required
The tools sit behind an active Ryze AI plan or free trial. Start the trial, then ask again.
A CMS source-code file will not read
CMS source-code file endpoints return raw files and fail through the read tool. Ask about blog content instead.

Terms on this page

MCP
The Model Context Protocol. Perplexity uses it to call tools on an outside server, which is how the Ryze AI connector brings HubSpot into a thread.
Custom remote connector
Perplexity's name for an MCP server you add yourself by its https:// address on the Plugins page.
Dynamic client registration
An OAuth feature through which Perplexity registers itself with a server, so the Client ID and Client Secret fields stay empty.
Portal
One HubSpot account. A Ryze AI connection points at one portal, and a workspace can hold several.
Scope
A permission an app requests when it is installed. Each scope opens a set of HubSpot API endpoints and the data behind them.
Filter group
A block of filters in a HubSpot search, joined with AND inside the block and with OR between blocks.
Recycling bin
Where HubSpot keeps deleted CRM records. They can be brought back for up to 90 days.

Sources: Perplexity help: adding custom remote connectors, HubSpot scopes, HubSpot CRM search, restoring deleted records. Checked November 14, 2026.

Frequently asked questions

How do I connect Perplexity to HubSpot?

In Ryze AI open Integrations, click Connect on HubSpot, sign in, choose the account and approve the permissions. Then in Perplexity open Plugins, Add custom, Add MCP connector, Remote, enter https://connector.get-ryze.ai/mcp, set Authentication to OAuth and select Add. Select the connector card to sign in.

Is there a Perplexity HubSpot connector?

Perplexity lets Pro, Max and Enterprise subscribers add a custom remote MCP connector by URL, and the Ryze AI connector is one you can add that way. HubSpot also runs its own remote MCP server at https://mcp.hubspot.com, but HubSpot's documentation does not name Perplexity as a client and this page did not verify it there. Windsor.ai and Coupler.io, two hosted data services that read HubSpot, also name Perplexity on their own pages.

Which HubSpot connector should I use with Perplexity?

Ryze AI is the best HubSpot connector for Perplexity when you want CRM reads and edits through a URL that Perplexity can add with OAuth and no client ID, though it covers 5 tools and needs a Ryze AI plan or trial. HubSpot's own server covers more content types but is not confirmed for Perplexity.

Does HubSpot have its own connector for Perplexity?

No. HubSpot's ready-made AI connectors are for ChatGPT, Claude, Gemini and Microsoft Copilot, and none of the HubSpot pages read for this guide on November 14, 2026 names Perplexity as a client.

Which Perplexity plan do I need?

Perplexity's March 2026 changelog says Pro, Max and Enterprise subscribers can add a custom remote connector. In an Enterprise organization, members need an administrator to turn on Allow members to add custom connectors, which is off by default.

What HubSpot permissions do I need?

Be a Super Admin or have App Marketplace Access in HubSpot. Other users need a Super Admin to approve the install first.

Can Perplexity edit or delete HubSpot records?

Yes. Through Ryze AI it can create and update contacts, companies, deals and CMS blog posts, and delete records or blog posts when you ask. Most CRM deletes go to HubSpot's recycling bin, where they can be restored for 90 days; deleted blog posts may not be recoverable. Perplexity says it asks before consequential writes, but name the exact records in your request anyway.

Does Perplexity ask before it changes HubSpot?

Yes, for consequential writes: Perplexity's connector troubleshooting article says an approval card appears before they run, without listing which calls count. Since August 24, 2026 a connector tool can also be set to Always ask, though Perplexity does not say whether custom connectors offer it. The Ryze AI chat's own Tool approvals setting starts on Skip all approvals.

Can Perplexity read HubSpot tickets?

Not through the default Ryze AI connection. A ticket search in the November 14, 2026 test was refused with the status not_allowed, while searches on contacts, companies and deals worked. HubSpot's remote MCP server reads tickets, but HubSpot does not name Perplexity among its clients.

Can Perplexity edit HubSpot lists?

No. Ryze AI reads contact lists and looks up owners, but it does not edit lists. The edit and delete tools apply to CRM contacts, companies and deals and to CMS blog content.

How many HubSpot records can Perplexity fetch in one call?

Up to 200 per search page and 100 per hubspot__listObjects call. HubSpot stops any single search at 10,000 results and allows 5 search requests per second per account, so ask Perplexity to page through bigger sets.

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 and is used unless you name another in chat.

Why do the HubSpot tools not show up in Perplexity?

If you connected HubSpot in Ryze AI after adding the connector, remove the Ryze AI connector under Plugins, add it again and start a new thread. Also check that the Ryze AI workspace has an active plan or free trial.

How much does it cost to connect Perplexity 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 Perplexity?

Delete the Ryze AI connector in Perplexity under Plugins. To cut HubSpot off at the source, disconnect the portal with the trash icon on the HubSpot card in Ryze AI or uninstall the app in HubSpot under Connected Apps.

Connect HubSpot to Perplexity in one URL

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.