How to add HubSpot MCP Server to Claude Desktop
HubSpot's hosted MCP server: OAuth in, then agents read and write CRM contacts, deals, tickets and engagements. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.
Last updated June 14, 2026 · 0★ · http · oauth · official
Claude Desktop config for HubSpot MCP Server
claude mcp add --transport http hubspot https://mcp.hubspot.com/anthropic{
"mcpServers": {
"hubspot-mcp-server": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.hubspot.com/anthropic"
]
}
}
}Claude Desktop connects to remote servers through the `mcp-remote` proxy (installed on first run via npx). Restart Claude Desktop after saving.
Setup steps
- 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
- 2Paste the HubSpot MCP Server config below under the top-level "mcpServers" key.
- 3Fill in any placeholder secrets (API keys, paths) in the snippet.
- 4Save the file, then fully quit and reopen Claude Desktop.
- 5Open a chat and confirm HubSpot MCP Server's tools appear under the 🔌 tools menu.
Before you start
- A HubSpot account (any plan tier); a Super Admin must authorize the connector for the portal the first time
- An MCP client that supports remote HTTP servers with OAuth (Claude, Claude Code, Cursor)
- For the packaged Claude connector: a paid Claude plan (Pro, Max, Team, or Enterprise)
Security
Hosted by HubSpot; auth is OAuth 2.0 against your portal, so no tokens sit in local config. The server can create and update CRM records — HubSpot's connector settings let you set write tools to require approval, and access is revocable anytime under Settings → Integrations → Connected Apps.
HubSpot MCP Server + Claude Desktop FAQ
Where is the Claude Desktop config file?
Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the HubSpot MCP Server config there under the "mcpServers" key and restart the client.
Is HubSpot MCP Server safe to use with Claude Desktop?
Hosted by HubSpot; auth is OAuth 2.0 against your portal, so no tokens sit in local config. The server can create and update CRM records — HubSpot's connector settings let you set write tools to require approval, and access is revocable anytime under Settings → Integrations → Connected Apps.
Is the HubSpot MCP server free and safe to use?
The server itself is free with any HubSpot subscription, and it's the official hosted endpoint — OAuth-scoped, no credentials stored locally, revocable from Connected Apps. The main caveats: Claude's packaged connector requires a paid Claude plan, and write tools can modify real CRM records, so enable HubSpot's approval setting for writes.
What is the HubSpot MCP endpoint URL?
The server lives at https://mcp.hubspot.com; Claude clients use the https://mcp.hubspot.com/anthropic path with Streamable HTTP transport and OAuth 2.0. There is nothing to install — add the URL to your MCP client and authenticate in the browser.
Can it write to my CRM or only read?
Both. CRM objects (contacts, companies, deals, tickets, invoices and more) and engagements are read/write, while users, teams, campaigns and CMS content (landing pages, blog posts) are read-only. Admins can force write operations to require per-action approval.