HubSpot MCP Server
OfficialHubSpot's hosted MCP server: OAuth in, then agents read and write CRM contacts, deals, tickets and engagements.
Add to your client
Copy the config for your MCP client and paste it into its config file.
claude mcp add --transport http hubspot https://mcp.hubspot.com/anthropicPaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"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.
Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf
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)
About HubSpot MCP Server
HubSpot runs this as a hosted Streamable HTTP endpoint. The base resource is https://mcp.hubspot.com (its OAuth protected-resource metadata confirms this and points back to developers.hubspot.com/mcp as the documentation), and Claude clients connect via the /anthropic path — claude mcp add --transport http hubspot https://mcp.hubspot.com/anthropic is the one-liner for Claude Code. Authentication is OAuth 2.0 today, with HubSpot announcing a migration to OAuth 2.1 (PKCE plus refresh-token rotation).
Capability-wise it maps closely to HubSpot's CRM API: read/write on core CRM objects (contacts, companies, deals, tickets, invoices, quotes, orders, subscriptions, segments) and engagements (calls, emails, meetings, notes, tasks), plus read-only access to users, teams, roles, campaigns, landing pages, website pages and blog posts. That makes it useful for real workflows — logging a call summary, updating deal stages, drafting follow-ups from engagement history — not just lookups.
Setup has one wrinkle: the underlying access runs through HubSpot's newer developer platform, and a Super Admin (or user with App Marketplace permissions) must authorize the connector once before other users in the portal can connect. In Claude specifically, the packaged HubSpot connector (Settings → Connectors) handles discovery and OAuth for you, but requires a paid Claude plan (Pro, Max, Team, Enterprise).
The trade-off of a hosted server: you can't self-host it, extend it, or see the tool implementations, and HubSpot controls the tool surface and rate limits. If you need a self-hosted alternative, the community server baryhuang/mcp-hubspot (Python, API-key based) exists but is far less capable and less maintained than the official endpoint.
When to use it
- Ask an agent to summarize a deal's full engagement history (calls, emails, meetings) before a customer call
- Create or update contacts, companies and deals from meeting notes without opening HubSpot
- Triage and update support tickets in bulk from Claude, with write-approval turned on
- Pull campaign, landing-page and blog data into competitive or performance analyses
Quick setup
- 1In Claude: Settings → Connectors → Browse connectors → add HubSpot, then click Connect and log in to your portal (admin authorizes first)
- 2In Claude Code: run `claude mcp add --transport http hubspot https://mcp.hubspot.com/anthropic`
- 3Complete the OAuth flow in the browser and select the HubSpot account to link
- 4Optional but recommended: in HubSpot, set the connector's write tools to 'Needs Approval' (Settings → Integrations → Connected Apps)
- 5Test with a read query like 'list my open deals' before allowing writes
Security notes
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 FAQ
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.
Alternatives to HubSpot MCP Server
Compare all alternatives →
AI-powered task-management system for AI-driven development that drops into Cursor, Windsurf, Claude Code, and more.
Gives AI assistants deep knowledge of 2,000+ n8n nodes, plus optional workflow management on your own n8n instance.
Background computer-use MCP server that drives native macOS, Windows, and Linux desktop apps without stealing focus.
Compare HubSpot MCP Server with: