HubSpot runs its own MCP server, and the easy way to connect Claude to it takes about five minutes: add https://mcp.hubspot.com/anthropic as a custom connector in Claude Desktop, sign in with OAuth, and approve the scopes you want.
The remote server went generally available in April 2026. There are four ways to connect in all, but the first one covers nearly everyone. Once it’s connected, you can ask your CRM questions in plain English instead of building a report every time.
- Easiest setup: the remote HubSpot MCP server at mcp.hubspot.com. Add it as a custom connector, sign in with OAuth, done. No install.
- What it does: reads and writes contacts, companies, deals, tickets, notes, and engagement history in plain language, with dozens of tools behind it.
- For local control: the older npm server (
@hubspot/mcp-server) runs on your machine with a private app token, but it was last published in June 2025 and HubSpot is retiring new private app creation. - Pair it with a bookmarks MCP. HubSpot holds your CRM. The competitor posts and prospect threads you save on X and LinkedIn live somewhere else. ContextBolt brings both into one prompt.
Which way should you connect HubSpot to Claude?
There are four routes, and the right one depends on whether you want zero setup, everything running on your own machine, or you’re building HubSpot apps.
| Path | Install | Auth | Best for |
|---|---|---|---|
| Remote MCP server (mcp.hubspot.com) | None | OAuth, scope approval | Almost everyone. The default pick. |
| HubSpot Connector for Claude | None (from Claude’s Connectors directory) | OAuth via the HubSpot connector | Claude users who want the click-to-add route |
Local npm server (@hubspot/mcp-server) | npx, on your machine | Private app access token | People who want everything running locally |
| Developer MCP server | HubSpot CLI | CLI auth | Developers building HubSpot apps and CMS assets |
If you just want to ask your CRM questions, use the remote server or the HubSpot Connector for Claude. They’re the same OAuth-backed connection with two front doors. The local npm server is for people who need the server process on their own hardware, and its token route is closing. The Developer MCP server is only for writing HubSpot apps, because it’s built for building on the platform, not for daily CRM work.
How do you set up the remote HubSpot MCP server?
The connection is hosted by HubSpot and authenticated with OAuth 2.1 with PKCE, so no access token ever lands in your config.
- Open the connector screen. In Claude Desktop, go to Customize, then Connectors, then the + button, then Add custom connector. On Team and Enterprise plans an Owner adds it under Organization settings, then Connectors.
- Paste the HubSpot MCP URL. Use
https://mcp.hubspot.com/anthropic, the path HubSpot publishes for Claude clients. Name the connector something you’ll recognize, like “HubSpot CRM.” - Sign in and approve scopes. Claude sends you to HubSpot. Log in, pick the account or portal to connect, and approve the scopes. If you only want the agent to read, don’t approve write scopes. You can widen them later.
- Restart Claude Desktop. Fully quit and reopen it (Cmd-Q on macOS, close it completely on Windows). A window reload does not pick up a new connector, and this trips up roughly half the people who think their setup is broken.
- Test it. In a new chat, ask “how many open deals do I have in HubSpot, and what is the total value?” Claude calls the deal tools and returns the numbers.
To skip the connector screen, HubSpot also ships the HubSpot Connector for Claude. Open your Claude settings, go to Connectors, then Browse, pick HubSpot, and connect. It needs a paid Claude plan, and a HubSpot Super Admin may have to approve it first for other users. It’s the same underlying server with a friendlier on-ramp.
The connection runs through HubSpot’s servers. That’s fine for almost everyone. If your security team needs the server process on your own infrastructure, use the local server below.
What tools does the HubSpot MCP server have?
The Model Context Protocol is an open standard Anthropic released in late 2024. A server exposes a set of tools, the client calls them mid-conversation, and the results flow back into the model’s reasoning. The remote server went generally available in April 2026, graduating from beta with write access, activity history, and marketing content objects added. The full reference is in the HubSpot MCP docs.
HubSpot’s docs list dozens of tools, covering the objects marketing, sales, and service teams touch every day:
- Read access: contacts, companies, deals, tickets, line items, products, quotes, invoices, and lists. Also activities like calls, emails, meetings, notes, and tasks, plus marketing content like campaigns and landing pages.
- Write access: the core records and activities.
You don’t need to memorize the tool list. You ask a question and the agent picks the tool.
What can you do with it once it’s connected?
A connected CRM feels underwhelming for five minutes and obvious after a week. People tend to use it in four ways.
Sales: “What was our last interaction with Acme Corp, and what stage is the deal in?” Claude reads the engagement timeline and the deal record and answers in a sentence. It works for pipeline triage too: “Summarize every deal in the negotiation stage worth more than $10,000 and flag any with no activity in two weeks.”
Marketing: Because the server reads marketing content and CRM data together, you can ask “which campaigns sourced the contacts that turned into open deals this quarter?” That normally means stitching two reports together by hand. Huble’s rundown of MCP use cases in HubSpot walks through more of these cross-hub questions.
Operations: “Find contacts with no associated company” or “show me deals missing a close date.” The agent runs the search and hands you the list.
Logging and updates: With write scopes approved, you can say “log a call with this contact and set a follow-up task for Friday,” and the record updates without you opening the form.
“Summarize all deals in the decision-maker-bought-in stage with a value over $5,000, and tell me which ones have gone quiet.”
That one prompt replaces a saved filter, a manual scan, and a mental note to follow up. It’s the report you’d have built anyway, asked in one line.
Is it safe to give Claude write access to HubSpot?
Start read-only. The remote server can create and update records once you approve write scopes, and a wrong bulk update to a pipeline is not a fun afternoon. Watch what the agent does when you ask it to draft an update, and approve write scopes once you have a feel for how it behaves.
The agent also inherits the scopes of the connection, so it can’t see data the OAuth grant doesn’t cover. “Claude couldn’t find that deal” sometimes means you didn’t grant that scope, not that the deal doesn’t exist.
Two more limits to know:
- It answers, it doesn’t monitor. MCP is request and response. It won’t watch your CRM and ping you when a deal goes cold. That’s a workflow or a HubSpot automation. For follow-ups that come to you, our Claude CRM guide compares a connector with a pipeline board that reminds you on the day.
- Big queries get heavy. Pulling thousands of records in one go is slow and can hit context limits. “Deals in this stage, closing this quarter” beats “tell me about all my deals.”
How do you use the local npm server instead?
HubSpot published an open-source server as the npm package @hubspot/mcp-server. It runs on your machine and talks to the HubSpot API with a private app access token. The package was last published in June 2025 and its GitHub repository is now empty, so treat it as unmaintained. HubSpot also renamed private apps to legacy apps and is disabling creation of new ones, on Sep 28, 2026 for accounts created that day or later and on Oct 26, 2026 for existing accounts. Existing legacy apps keep working.
- Find a legacy private app. In HubSpot, go to Development, then Legacy apps. If you don’t already have one, you may not be able to create one. Give it the CRM scopes you need and copy the access token. Treat it like a password.
- Add the server to your Claude Desktop config. Open Settings, then Developer, then Edit Config, which opens
claude_desktop_config.json. Add the block below with your token in the env value. - Restart Claude Desktop. Full quit and reopen, not a window reload.
- Confirm the tools loaded. Ask Claude to “list your HubSpot tools” or run a read query. If the token’s scopes are too narrow, you get a permissions error rather than a broken server.
{
"mcpServers": {
"hubspot": {
"command": "npx",
"args": ["-y", "@hubspot/mcp-server"],
"env": {
"PRIVATE_APP_ACCESS_TOKEN": "your-token-here"
}
}
}
}
The -y on the npx command isn’t optional. Without it, npx waits for an interactive install prompt that Claude can’t answer, and the process hangs. That one missing flag is behind a surprising share of “my MCP server will not start” complaints across every community server.
Don’t commit claude_desktop_config.json to a repo or paste it in a shared doc, because the token is live CRM access in plain text. Rotate it if it ever leaks.
Why isn’t my HubSpot MCP connection working?
The same few issues come up again and again.
- You reloaded instead of restarting. Claude Desktop reads its connector list at full startup only. Quit fully, reopen, then check.
- The scopes are wrong. If the agent keeps saying it can’t find or can’t update something, revisit the OAuth grant or the private app permissions and add what’s missing. Under-granting is the safer error to have.
- Too many servers are running. Each MCP server is a subprocess with startup and memory cost. Past ten, you feel it. Three to six is the sweet spot.
- You expected a HubSpot replacement. It’s a conversational layer on top of HubSpot. The reports, automations, and dashboards still live in the app.
Can Claude read my saved research next to my CRM?
Your CRM is only half of what you know about a prospect. The other half is the competitor’s launch thread you bookmarked on X, the LinkedIn post from the prospect’s VP of Sales, and the Reddit thread where their customers complained about the tool you’re replacing. None of it is in HubSpot.
A bookmarks MCP fills that gap. ContextBolt is a Chrome extension that saves any web page with its text and captures what you save on X, Reddit, and LinkedIn as you save it, tags each save by topic automatically, and on Pro exposes the whole collection through a personal MCP endpoint. Basic is free, with no account and no card. It’s capped at 150 bookmarks. Pro at $6 a month removes the cap, adds cloud sync, and turns on the MCP endpoint any client can call.
Wire it in the way you wired HubSpot: add the custom connector, paste your endpoint, restart. Then “pull the open deal for Acme and anything I’ve saved about their space” returns the pipeline record and the threads you bookmarked about their market. The Claude Desktop integration guide has the walk-through.