Be the first to get access to new connectors. Get early access →
ConnectorBay Early access
Discover
HubSpot (BYOK) icon

HubSpot (BYOK)

Read your HubSpot CRM contacts, companies and deals, and search them, with BYOK

Unify Dynamics LLC

Documentation
Tools9read-only
Sign-inBYOKbring your own key
Key keptNeverused for one call only
PriceFreeoptional Pro limits
ProviderHubSpotunofficial, not affiliated
Works withMCP · RESTany agent

Try asking

Real questions, and the tools your agent calls to answer them.

Show my latest HubSpot contacts
Tools called
list_contacts
Look up the HubSpot contact jane@example.com
Tools called
get_contact
Find HubSpot contacts named Jane
Tools called
search_contacts
Show my HubSpot companies
Tools called
list_companies
Show the details of one HubSpot company
Tools called
get_company
Find the HubSpot company acme.example
Tools called
search_companies

About

HubSpot (BYOK) lets an AI assistant read your own HubSpot data through the HubSpot API with a key you supply (private app access token (give the app read scopes only, such as crm.objects.contacts.read)). Read-only: 9 tools (list_contacts, get_contact, search_contacts, list_companies, get_company, search_companies, list_deals, get_deal, search_deals). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to api.hubapi.com. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by HubSpot. HubSpot and its logos are trademarks of their owners and are used only to say which service the connector works with.

Sources: Live from the HubSpot API (api.hubapi.com) with a BYOK key; documentation: https://developers.hubspot.com/docs/api-reference/overview. Endpoints checked against that documentation on 2026-10-16.

Privacy

The publisher, Unify Dynamics LLC, states that tool inputs are processed in memory and not retained.

Data not collectedNo account, no profile, no stored prompts or results.
Privacy policyTerms

What it can do

9 tools, grouped by job. Every one is read-only or compute-only.

OpenAPI
Read your data9 tools
  • List contactsList CRM contacts (default properties: email, first and last name, created and last modified date) with a cursor for paging; ask for more…
  • Get contactGet one CRM contact by record id, or by email address when id_property is set to email, with the properties requested.
  • Search contactsSearch CRM contacts by text across default searchable properties such as name, email and phone, 200 results per page at most (the search returns…
  • List companiesList CRM companies with a cursor for paging; ask for properties such as name, domain, industry and number of employees by name.
  • Get companyGet one CRM company by record id with the properties requested.
  • Search companiesSearch CRM companies by text across default searchable properties such as name, domain, website and phone, 200 results per page at most.
  • List dealsList CRM deals with a cursor for paging; ask for properties such as dealname, amount, dealstage, pipeline, closedate and hubspot_owner_id by name…
  • Get dealGet one CRM deal by record id with the properties requested (stage and pipeline appear as internal ids).
  • Search dealsSearch CRM deals by text across default searchable properties such as deal name, pipeline, stage and description, 200 results per page at most.

Information

PublisherUnify Dynamics LLC
CategoryWork & productivity
LanguagesEnglish
Built forWorldwide
CompatibilityAny MCP client · any agent · REST
Version0.1.0
MCP endpointhttps://byok-hubspot.connectorbay.com/mcp
REST APIopenapi.json
SupportGet help · Status
CountryWorldwide
FunctionOther
LayerDeep connectors

Connect it to your agent

Three ways in, the same 9 tools.

MCP (Claude, Cursor, Windsurf, VS Code, any MCP client)https://byok-hubspot.connectorbay.com/mcp
RESTPOST https://byok-hubspot.connectorbay.com/v1/tools/<tool>
OpenAI function callinghttps://connectorbay.com/openai/byok-hubspot.json
OpenAI-compatible chathttps://connectorbay.com/v1/chat/completions · how it works
  • Add the MCP URL in your client's connector, MCP or integration settings (streamable HTTP, no OAuth).
  • Key: send your private app access token (give the app read scopes only, such as crm.objects.contacts.read) in the X-Upstream-Key header (get one at developers.hubspot.com).
  • Ask a question; the agent picks the right tool and answers from the live data.

HubSpot connector: questions and answers

What is the HubSpot connector?

HubSpot (BYOK) lets an AI assistant read your own HubSpot data through the HubSpot API with a key you supply (private app access token (give the… It is a hosted MCP server with 9 tools such as List contacts, Get contact, Search contacts, List companies, Get company, Search companies, published by Unify Dynamics LLC. It is independent and not affiliated with HubSpot.

How do I connect HubSpot to Claude, ChatGPT or Cursor?

Add the MCP endpoint https://byok-hubspot.connectorbay.com/mcp to your client's MCP, connector or integration settings (streamable HTTP, no OAuth). For REST, POST JSON to https://byok-hubspot.connectorbay.com/v1/tools/<tool>; the OpenAPI description is at /openapi.json. For OpenAI function calling, load https://connectorbay.com/openai/byok-hubspot.json.

Do I need a HubSpot account or API key?

Yes: this is a bring-your-own-key connector. Create a private app access token (give the app read scopes only, such as crm.objects.contacts.read) at https://developers.hubspot.com/docs/apps/legacy-apps/private-apps/overview and send it in the X-Upstream-Key header. ConnectorBay uses it for that one call only and never stores, logs or caches it.

Is HubSpot read-only?

Yes. Every tool reads or computes. Nothing is created, changed, sent, paid or deleted in your account.

Is the HubSpot connector free?

Yes. It is free to use within the published rate limits; an optional Pro key raises them. There is no account to create.

More like this

More in Other

Tiingo (BYOK)

Read Tiingo end-of-day stock prices, IEX intraday quotes, crypto prices, ticker metadata, ticker search and financial news with BYOK

Live · MCP + REST8 tools

Strava (BYOK)

Read your own Strava profile, activities, athlete totals, gear and routes with BYOK

Live · MCP + REST6 tools

Square (BYOK)

Read your Square locations, orders, payments, customers, catalog items and inventory counts with BYOK

Live · MCP + REST10 tools

spoonacular (BYOK)

Search recipes and ingredients and read recipe details and nutrition from the spoonacular food API with BYOK

Live · MCP + REST9 tools

Smartsheet (BYOK)

Read your Smartsheet sheets, rows, columns, reports, dashboards and workspaces, and search them, with BYOK

Live · MCP + REST10 tools

Scaleway (BYOK)

Read your Scaleway Instances, flexible IPs, volumes, snapshots, security groups and Projects with BYOK key

Live · MCP + REST7 tools

Get HubSpot (BYOK)

Free · BYOK · Read-only

BYOK: bring your own keyThis connector uses your own HubSpot private app access token (give the app read scopes only, such as crm.objects.contacts.read). Create one at https://developers.hubspot.com/docs/apps/legacy-apps/private-apps/overview, with the fewest permissions it needs (read-only if the provider offers it). Your assistant sends it in the X-Upstream-Key header with every request. It is used for that one call only: never stored, logged or cached, and only ever sent to HubSpot. Revoke it at the provider whenever you like. Unofficial connector: not affiliated with HubSpot.