HubSpot MCP Server: Tools, Setup and Limits (2026)

The short version

Yes, HubSpot has two official MCP servers. The HubSpot MCP server runs at https://mcp.hubspot.com, signs each person in with OAuth, and works with the HubSpot data that person can already see. It powers HubSpot's own connectors for Claude, ChatGPT, Microsoft Copilot and Gemini, and it has 32 tools across CRM records, segments, campaigns, marketing email, content, conversations and AEO. The Developer MCP server, generally available since February 19, 2026, runs on your machine through the HubSpot CLI for app and CMS work. HubSpot lists the Claude and ChatGPT connectors on all products and plans, and Claude needs a paid Anthropic plan. Through the connectors you create or update up to 10 records at a time, with view, create and update actions. We make Clu, which runs a contact-data MCP server, so read this as a vendor's review.

The HubSpot MCP server is HubSpot's official, hosted MCP server at https://mcp.hubspot.com. It lets Claude, ChatGPT, Microsoft Copilot, Gemini or your own agent search, create and update the HubSpot records you can already see, through 32 tools. Each person signs in with OAuth, and HubSpot lists no separate charge for it.

Facts checked October 30, 2026. Every HubSpot fact below comes from HubSpot's developer docs and its knowledge base articles for the Claude connector (updated October 19, 2026) and the ChatGPT connector (updated September 28, 2026), each read on October 30, 2026. We did not connect a HubSpot account for this review.

Does HubSpot have an official MCP server?

Yes. HubSpot builds and runs both of these:

	HubSpot MCP server (remote)	HubSpot Developer MCP server (local)
Where it runs	`https://mcp.hubspot.com`	Your machine, through the HubSpot CLI
Built for	People working with CRM data in an AI tool, and teams adding HubSpot to their own agent	Developers building HubSpot apps, CMS themes and serverless functions
Sign-in	OAuth with PKCE, as the user	The HubSpot CLI
Clients	Claude, ChatGPT, Microsoft Copilot, Gemini and other MCP clients	Claude Code, Codex CLI, Cursor, Gemini CLI, VS Code and Windsurf
Status	Live, 32 tools	Generally available since February 19, 2026

In practice, people who work in Claude or ChatGPT install HubSpot's connector, and teams building their own agent create an MCP connector in HubSpot.

What tools does the HubSpot MCP server have?

HubSpot documents 32 tools. Grouped by job:

Account and setup (6): get_user_details, get_organization_details, discover_hubspot_schema, tool_guidance, manage_onboarding, submit_feedback.
CRM records (6): search_crm_objects, get_crm_objects, manage_crm_objects, query_crm_data, search_owners, manage_segment.
Properties and pipelines (4): search_properties, get_properties, manage_custom_properties, manage_custom_pipelines.
Signals and conversations (3): search_intent_signals, search_conversations, get_conversation_channel_metadata.
Campaigns and email (5): get_campaign_attribution_reports, read_campaign_data, manage_campaign_objects, get_marketing_email_analytics, manage_marketing_email.
Content (5): get_content_analytics_report, manage_landing_page, manage_website_page, manage_blog_post, render_asset.
AEO (3): get_aeo_metrics, manage_aeo_prompts, manage_aeo_recommendations.

The ones a sales or RevOps team uses most, with the limits HubSpot documents:

Tool	What it does	Limit
`get_user_details`	Your user, account and read and write access per object	Run it first to see what your account gets
`search_crm_objects`	Searches and filters records	5 filter groups of 6 filters each, 200 results a page
`get_crm_objects`	Fetches records by ID	100 IDs per request
`manage_crm_objects`	Creates or updates records and activities	Asks for your confirmation
`query_crm_data`	Queries CRM data with SQL and HubSpot extensions
`search_owners`	Finds record owners by name, email or ID	100 results
`manage_segment`	Creates segments and adds or removes records in static ones
`search_intent_signals`	Searches and counts buyer intent signals

How do I connect HubSpot to Claude or ChatGPT?

Super Admins and users with App Marketplace Access can connect right away. Everyone else needs a Super Admin to approve the connector first. During approval, the Super Admin picks the connector's data permissions and who in the account can install it.

Claude:

Click your profile icon in the bottom left, then Settings, then Connectors.
Click Browse, search for HubSpot, select it and click Connect.
Log in to HubSpot and pick the account.
Choose the permissions to allow and click Connect app.
In a chat, click the plus sign, then Connectors, and toggle HubSpot on.

ChatGPT:

Click your profile icon in the bottom left, then Settings, then Apps.
Select HubSpot, click Connect, then Continue to HubSpot.
Log in, pick the account, choose permissions and click Connect App.

In both clients, HubSpot recommends setting Write tools to Needs Approval. Always allow can let edits go through without a confirmation.

How do I connect my own agent to the HubSpot MCP server?

Create an MCP connector in HubSpot:

In HubSpot's main navigation, click Development, then MCP Connectors in the left sidebar.
Click Create MCP connector.
Enter a name, an optional description, a redirect URL for OAuth and an optional icon, then click Create.
HubSpot generates the client ID and client secret on the connector's details page.

Then point your MCP client at https://mcp.hubspot.com with that client ID, client secret and a matching redirect URL. Your client must handle the OAuth flow with PKCE. To test, HubSpot walks through MCP Inspector: add http://localhost:6274/oauth/callback/debug as a redirect URL, connect over Streamable HTTP to https://mcp.hubspot.com/, finish the OAuth flow, click List Tools and run get_user_details.

How do I set up the HubSpot Developer MCP server?

You need HubSpot CLI version 8.2.0 or higher:

hs --version
npm install -g @hubspot/cli
hs mcp setup

HubSpot also documents a standalone mode that runs npx @hubspot/cli in place of a global install. Once set up, the server helps with setting up and changing HubSpot apps, CMS themes, templates and modules, serverless functions, app analytics and troubleshooting, with context from HubSpot's developer docs.

Is the HubSpot MCP server free?

No HubSpot page we read lists a separate charge for it.

Claude connector: available with all HubSpot products and plans. Claude itself needs a paid Anthropic plan: Pro, Max, Team or Enterprise.
ChatGPT connector: available to all HubSpot customers across all tiers with an OpenAI account.
Usage: every call counts against HubSpot's API usage limits.
Tools tied to editions: the AEO tools need Marketing Hub Professional or Enterprise, quotes (beta) need Revenue Hub Professional or Enterprise, and accounts on HubSpot's free tools cannot create custom pipelines.

Tool access also depends on your permissions and account setup, which is why HubSpot suggests running get_user_details after you connect.

What should you know before rolling it out?

Writes come in batches of 10. The Claude and ChatGPT connectors create or update up to 10 records at a time.
View, create and update. Deletes stay in HubSpot.
Validation differs by client. Through Claude, conditional property rules and pipeline stage validations apply, and association label validations do not. Through ChatGPT, custom validation rules are not applied.
Sensitive Data. With Sensitive Data turned on, activity and conversation data are blocked over MCP, and custom Sensitive Data properties are never exposed.
One account per client. One Claude or ChatGPT account connects to one HubSpot account at a time.
Client-specific tools. manage_website_page, manage_blog_post and render_asset work only in Claude, ChatGPT and Gemini.
Data in your account. The server works on the records in your HubSpot account, so new contacts and verified emails come from a data source beside it.
Queries have limits. query_crm_data does not support joins, column aliases, subqueries, association traversal or currency conversion, and the server's search is built on HubSpot's CRM search API, which has no vector search (checked November 4, 2026).

Security and permissions

HubSpot's controls sit in three places:

User permissions. Each person sees and edits only the records they can see and edit in HubSpot, and restricted inboxes stay restricted.
Admin approval. A Super Admin picks the connector's data permissions and who can install it.
Audit log. Creates and updates through the Claude connector are attributed to both the user and the connector, and Super Admins can see who connected and when.

Claude Enterprise admins can also limit the connector to company Claude accounts on a verified domain.

HubSpot's ChatGPT connector article adds one data note: when you use the HubSpot MCP server, HubSpot may collect summaries of tool calls, such as the intent of a request and whether it succeeded, and it takes steps to anonymize the names of people, companies and deals (checked November 4, 2026).

HubSpot MCP and Clu MCP together

HubSpot stays the system of record. A data server adds the people who are not in it yet. Clu makes the data server in this example, so read it as a vendor's example.

The prompt. "Find Heads of Finance and Controllers at the companies I own in HubSpot with lifecycle stage Lead, skip anyone already in HubSpot, get verified work emails and phone numbers, and create them as contacts on the right company."

HubSpot search_owners finds your owner ID, and search_crm_objects returns your companies and their domains.
Clu search_people searches those domains for the titles. Search costs nothing.
HubSpot search_crm_objects on contacts checks borderline names, and Claude drops the matches.
Clu create_list and add_leads_to_list save the rest, estimate_cost quotes the enrichment, enrich_list runs the waterfall for work emails and phone numbers, and enrich_status waits for it.
HubSpot tool_guidance returns the association rules, and manage_crm_objects creates each contact on its company, 10 at a time, after your yes.
HubSpot manage_segment adds the new contacts to a static segment, ready for a workflow or sequence in HubSpot.

Teams on Clu's Pro or Enterprise plan can skip step 5, because Clu's HubSpot sync writes enriched records to HubSpot and imports from it on a schedule.

Our other reviews cover the Salesforce MCP server, the Attio MCP server, the Pipedrive MCP server, the Gong MCP server and the ZoomInfo MCP server. The full field is in the best MCP servers for sales and GTM.

Where Clu fits

Disclosure. We make Clu, and this entry is our own description of our product.

Clu is the data side of the flow above: people and company search, and verified work emails and phone numbers from a waterfall of 25+ providers. Its MCP server is included from Starter, HubSpot sync comes with Pro and Enterprise, and the 14-day Pro trial includes MCP. Setup is on the Clu MCP page.

Our product

Clu

Best for: lean GTM teams that want one platform in place of 3 to 5 tools: AI agents that find buyers, get verified emails and phone numbers from 25+ providers and send the sequences.

Clu publishes this page. Accuracy figures are from our own benchmark, not a third-party test.

Clu runs waterfall enrichment across 25+ data providers in sequence and stops at the first deliverable result, at 1 credit per verified work email and 10 per phone number. A missed email or phone number costs nothing. It returns 98% verified work emails and 85% phone numbers on the Clu 500-Lead Enrichment Benchmark, which is our own test run on a 500-lead sample. Plans start at $49 per seat a month.

Clu, our GTM agent, turns one sentence into an agent that searches 1B+ profiles, enriches and verifies every person it finds, adds them to a sequence and posts each run to Slack, every week or on a CRM trigger.

Product: Clu and agents
People and Company Search
Waterfall enrichment
Email verification
ICP scoring
Sequences
CRM sync
Chrome extension
MCP and API
Plans: Free plan 50 credits a month. Starter $49 and Pro $89 per seat a month, and every seat adds its credits to one shared balance. Enterprise is custom. 25% off on annual billing.
Credits: Verified work email1
Phone number10
Both on one row11
Validation0.5
AI qualification5
Trial: 14 days of Pro, free: 250 credits, 3 seats, agents, Sequences and Clu in Slack.
Fits when: You prospect from Claude or ChatGPT and want the people your HubSpot account does not have yet, with verified work emails and phone numbers
You want enriched contacts written to HubSpot by Clu's sync on Pro or Enterprise
You want an agent to enrich every new HubSpot contact on a CRM trigger, which starts on Pro
Pairs with: HubSpot's MCP server and connectors, for reading and updating the records you already have
HubSpot sequences and workflows

See pricing

Frequently asked questions

How do I disconnect HubSpot from Claude or ChatGPT?

In Claude, click your profile icon, then Settings, Connectors, HubSpot and Disconnect. In ChatGPT, go to Settings, Apps, Enabled apps, HubSpot and click Disconnect.

What happens when a connector's permissions change?

Users reinstall it. HubSpot sets scopes from the tools available at install and the permissions each user grants, so when scopes change, every user installs the connector again.

Why can't the connector see some activities or conversations?

Two settings decide it. Accounts with Sensitive Data turned on block activity and conversation data over MCP, and conversations in restricted inboxes are visible only to the users or teams given access.

Does performance data cover draft pages?

No. HubSpot's ChatGPT article says only published website pages, landing pages and blog posts return performance data, and drafts return metadata only. A performance query for one page or post needs a campaign name and a date range.

What is the HubSpot MCP server URL?

The HubSpot MCP server URL is https://mcp.hubspot.com. In most AI tools you add it as a new MCP server connection and sign in to HubSpot when prompted. A custom agent also needs the client ID and client secret of an MCP connector you create in HubSpot under Development, then MCP Connectors, and its OAuth flow must use PKCE (checked November 4, 2026). The Developer MCP server is different: it runs on your machine, and hs mcp setup adds it to your coding tool as HubSpotDev.

How many tools does the HubSpot MCP server have?

HubSpot documents 32 tools (checked November 4, 2026). They cover CRM records and activities, SQL-style queries, properties, pipelines, segments, buyer intent, conversations, campaigns, marketing email, web pages, blog posts and AEO. Which ones you get depends on your HubSpot subscription, permissions and account setup, so run get_user_details after you connect. To add new contacts beside it, see which enrichment servers pair with HubSpot in our comparison of 10 MCP servers.

Does the HubSpot MCP server work with Claude?

Yes. HubSpot's connector for Claude runs on the HubSpot MCP server and works in Claude on the web, desktop and mobile. You need a paid Anthropic plan (Pro, Max, Team or Enterprise), and a Super Admin must approve the connector unless you are a Super Admin or have App Marketplace Access. To connect, open Settings, then Connectors, click Browse, search for HubSpot and click Connect (checked November 4, 2026).

Does the HubSpot MCP server cost anything?

HubSpot lists no separate charge for it. Its knowledge base lists the Claude connector for all HubSpot products and plans, and the ChatGPT connector for all HubSpot customers across all tiers with an OpenAI account (checked November 4, 2026). Every call counts against HubSpot's API usage limits and Claude itself needs a paid Anthropic plan. The AEO tools need Marketing Hub Professional or Enterprise, and quotes need Revenue Hub Professional or Enterprise.

Is the HubSpot app in ChatGPT the same as the HubSpot connector?

Yes. HubSpot's knowledge base says they are the same, and ChatGPT may list the connector as the HubSpot app (checked November 4, 2026). It runs on the same HubSpot MCP server as the Claude connector, so the 10-record write limit and your HubSpot permissions apply in both.

What is the @hubspot/mcp-server package on npm?

It is a local HubSpot MCP server that HubSpot published on npm as a beta, under its Early Adopter Program terms. It runs on your machine through npx and authenticates with a private app access token, and its latest version, 0.4.0, came out on June 18, 2025 (npm, checked November 4, 2026). HubSpot's MCP page lists two servers: the hosted HubSpot MCP server, which signs each person in with OAuth, and the local Developer MCP server. Our census of 59 GTM vendors' MCP servers lists which vendors ran their own server on September 1, 2026, HubSpot included.

Sources

HubSpot, Using the HubSpot MCP server, read October 30, 2026
HubSpot, Integrate AI tools with the HubSpot MCP server, read October 30, 2026
HubSpot, HubSpot Developer MCP server, read October 30, 2026
HubSpot Developer Changelog, HubSpot Developer MCP server (local) for App and CMS Development Now in GA, February 19, 2026, read October 30, 2026
HubSpot, Set up and use the HubSpot connector for Claude, updated October 19, 2026, read October 30, 2026
HubSpot, Set up and use the HubSpot connector for ChatGPT, updated September 28, 2026, read October 30, 2026
HubSpot, HubSpot MCP Server, read November 4, 2026
npm, @hubspot/mcp-server, version 0.4.0 published June 18, 2025, read November 4, 2026
HubSpot's Using the HubSpot MCP server, Integrate AI tools, Developer MCP server and both connector articles above, re-read November 4, 2026 for the answers marked "checked November 4, 2026" (the ChatGPT connector article showed an update date of November 4, 2026)