Skip to main content
Guide1 min read

HubSpot MCP server: connect your CRM to Claude (2026)

Let an AI read and update HubSpot contacts, deals and companies via the official remote HubSpot MCP server. OAuth setup, config and common fixes.

HubSpot's official remote MCP server (GA since April 2026) connects an AI client to your CRM — contacts, companies, deals, tickets and engagements — so Claude can research accounts, update records and draft follow-ups. Here's the setup.

Setup — official remote server

Add HubSpot's hosted endpoint (mcp.hubspot.com) as a remote/OAuth connector:

{
  "mcpServers": {
    "hubspot": {
      "url": "https://mcp.hubspot.com/anthropic"
    }
  }
}

The exact path is shown in HubSpot's MCP settings for your client; authorise through HubSpot OAuth on first use and pick the portal. For stdio-only clients, bridge with npx -y mcp-remote <url>. Restart the client; see MCP config file location.

There's also a developer MCP

Separately, HubSpot ships a local developer MCP for app/CMS development (building on the HubSpot platform). That's different from the CRM data server above — pick based on whether you're working with CRM data or building HubSpot apps.

Verify

Ask: "Find the 5 deals closing this month in HubSpot and summarise each contact's last activity." Real CRM data back confirms it works.

Common problems

  • Wrong portal — re-run OAuth and select the right HubSpot account.
  • Missing scopes — your user/app lacks access to that object; adjust permissions in HubSpot.
  • mcp-remote errors — Node 18+; see Cursor MCP not working.

Security

CRM data is sensitive customer PII. Grant least-privilege access, prefer read-only when you don't need writes, and review what the connector can do. See MCP security best practices.

Going further

HubSpot pairs with Gmail and a web-search server for sales research. Browse the productivity category or curated loadouts.

Loadout

Build your AI agent loadout

The directory of MCP servers and AI agents that actually work. Pick the right loadout for Slack, Postgres, GitHub, Figma and 20+ integrations — with install commands ready to paste into Claude Desktop, Cursor or your own stack.

© 2026 Loadout. Built on Angular 21 SSR.