HubSpot CRM Official Remote MCP Server

🛡️ Official✓ VerifiedStreamable HTTPOAuth 2.1🛡️ A+~377 tok6 tools·Online294ms·30d uptime: 100%·Last checked 12m ago

HubSpot's hosted MCP (mcp.hubspot.com) exposes CRM objects — contacts, companies, deals, tickets — to agents for search, read and write workflows over OAuth 2.1.

https://mcp.hubspot.com
Provider
HubSpot ↗
Categories
📋 Project Management & Productivity🔌 Multi-App Gateways & Automation
中文简介

HubSpot 官方远程 MCP 服务器。AI 代理可通过 OAuth 搜索 CRM 对象(联系人、公司、商机)、读取属性并创建或更新记录。

Maintainer of HubSpot CRM? Claim or update this listing →

Streamable HTTPhttps://mcp.hubspot.com
Install in Cursor →

Or add to ~/.cursor/mcp.json:

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

🧰 HubSpot CRM MCP Tools & Schema (6)

ToolSafetyDescriptionParameters
search_contacts
~68 tok
🟢 ReadSearch CRM contacts by name, email or properties.query*: stringlimit: number
get_contact
~51 tok
🟢 ReadGet a contact with all properties.contactId*: string
create_contact
~52 tok
🟠 WriteCreate a new CRM contact.properties*: object
search_companies
~47 tok
🟢 ReadSearch CRM companies.query*: string
list_deals
~63 tok
🟢 ReadList deals with stage and pipeline filters.pipeline: stringstage: string
create_deal
~76 tok
🟠 WriteCreate a new deal in a pipeline.dealname*: stringpipeline: stringamount: string

🛡️ Security, Quality & Context Token Audit

🛡️ Grade A+Context tax: ~377 tokens injected into every system prompt by this server’s 6 tools

Every tool definition (name + description + input schema) is injected into your LLM’s context on every request — Estimate per-call LLM token cost →

  • No prompt-injection or hidden-character anomalies detected in tool descriptions
  • Streamable HTTP primary endpoint (current 2025-03-26 transport)
  • OAuth 2.1 with PKCE S256 enforced
  • Official first-party endpoint operated by the vendor
  • Manually verified by RemoteMCP.net

🔐 OAuth 2.1 & Security

Auth type
OAuth 2.1
Dynamic Client Registration
✅ Supported
PKCE S256
✅ Supported
Scopes
crm.objects.contacts.readcrm.objects.contacts.writecrm.objects.deals.read
Protected resource metadata
https://mcp.hubspot.com/.well-known/oauth-protected-resource (expected location)
🔐 Audit OAuth 2.1 Config →

🧩 Recommended Agent Skills

📖 HubSpot CRM MCP Endpoint Overview & Security Guide

HubSpot CRM MCP — Remote MCP Server

HubSpot's remote MCP opens the CRM graph to agents — search contacts and companies, pull deal pipelines, create activities — so an assistant can answer 'what's the state of the Acme deal' or log a follow-up without a human clicking through the CRM.

Official HubSpot CRM MCP Endpoint & Transport Architecture

  • Endpoint URL: https://mcp.hubspot.com
  • Transport: Streamable HTTP

Streamable HTTP is the current MCP transport (2025-03-26 spec): a single URL accepts JSON-RPC POSTs and may stream responses over SSE, so one endpoint serves both simple and streaming workloads. HubSpot CRM MCP does not publish a separate legacy SSE endpoint, so your client must speak Streamable HTTP.

Authentication, Scopes & Permission Boundaries

HubSpot CRM MCP uses OAuth 2.1 — the first request returns a 401 Unauthorized challenge with a WWW-Authenticate header pointing at the authorization metadata. Compliant clients (Cursor, Claude, VS Code, ChatGPT) handle the whole flow — PKCE and Dynamic Client Registration, so no manual client setup is needed — and simply open a browser consent screen.

Of the 6 cataloged tools, 4 are read-only and 2 can write or mutate state (create resources, run SQL, post messages). Grant access only to the accounts and projects you intend agents to act on, and prefer scoped credentials or a dedicated workspace where the provider supports them.

Common Troubleshooting & Connection Tips

  • 401 Unauthorized on connect — that's expected; the server is OAuth-protected. Let your client complete the browser consent flow, or inspect the endpoint in our OAuth debugger to see the exact WWW-Authenticate challenge.
  • "Session expired" / stale Mcp-Session-Id — just re-send initialize; stateless clients can ignore session headers entirely.
  • Requires a HubSpot user login; scope granularity follows the app's declared scopes.
  • Write tools respect HubSpot's property validation — invalid property names fail fast.

🚀 How to Connect

  1. Copy the HubSpot CRM MCP endpoint URL
    The remote endpoint is https://mcp.hubspot.com.
  2. Add it to your MCP client
    Claude Code: claude mcp add --transport http hubspot https://mcp.hubspot.com. Cursor: add "hubspot": { "url": "https://mcp.hubspot.com" } under mcpServers in ~/.cursor/mcp.json. Other clients work similarly.
  3. Complete the OAuth consent
    On first connection your client opens a HubSpot consent screen in the browser. Approve it to grant access; the token is stored by the client and refreshed automatically.
  4. Verify with the online inspector
    Paste https://mcp.hubspot.com into remotemcp.net/inspector, run initialize and tools/list, and confirm HubSpot CRM MCP's 6 tools respond.

❓ FAQ

What is the HubSpot CRM MCP remote MCP endpoint?

The primary endpoint is https://mcp.hubspot.com. It is an official first-party server operated by HubSpot, speaking the Streamable HTTP transport.

How do I authenticate with HubSpot CRM MCP?

HubSpot CRM MCP uses OAuth 2.1. When your client first connects it receives a 401 challenge, discovers the authorization server via RFC 9728 metadata, and opens a browser consent screen. Dynamic Client Registration is supported, so compliant clients register themselves automatically.

I'm getting a 401 Unauthorized from HubSpot CRM MCP — what's wrong?

A 401 means your client hasn't completed (or has lost) the OAuth authorization. Remove and re-add the server in your client to restart the consent flow, and check that your browser session can reach the provider's login page. If the 401 arrives without a WWW-Authenticate header, run it through our OAuth debugger to see what's missing.

Which MCP clients work with HubSpot CRM MCP?

Any client that supports remote MCP servers: Cursor, Claude Code (`claude mcp add --transport http hubspot https://mcp.hubspot.com`), VS Code Copilot, ChatGPT connectors, Windsurf, Kiro (`~/.kiro/settings/mcp.json`), and Claude Desktop via the `mcp-remote` bridge.

What tools does HubSpot CRM MCP expose?

6 tools are cataloged in this directory — including `search_contacts`, `get_contact`, `create_contact` and more. Use our online inspector to fetch the live tool list straight from the endpoint.

🔗 Connect Guides

📛 Embed Status Badge in README

HubSpot CRM MCP status badge
[![Remote MCP Status](https://remotemcp.net/api/badge/status/hubspot.svg)](https://remotemcp.net/servers/hubspot)
HubSpot CRM MCP inspector badge
[![Test in Inspector](https://remotemcp.net/api/badge/inspect/hubspot.svg)](https://remotemcp.net/inspector?url=https%3A%2F%2Fmcp.hubspot.com)
HubSpot CRM MCP audit grade badge
[![MCP Audit Grade](https://remotemcp.net/api/badge/grade/hubspot.svg)](https://remotemcp.net/servers/hubspot)
HubSpot CRM MCP context tax badge
[![Context Tax](https://remotemcp.net/api/badge/tokens/hubspot.svg)](https://remotemcp.net/servers/hubspot)

Related Servers

Notion MCPNotion Labs

Notion's official hosted MCP server. Agents can search your workspace, read and create pages, and query databases over Streamable HTTP or SSE.

https://mcp.notion.com/mcp
🛡️ Official✓ VerifiedHTTP + SSEOAuth 2.1🛡️ A+~606 tok18 toolsOnline21ms
Linear MCPLinear Orbit Inc.

Linear's official remote MCP server. Agents can search, create and update issues and query your team's workflow over Streamable HTTP or SSE.

https://mcp.linear.app/mcp
🛡️ Official✓ VerifiedHTTP + SSEOAuth 2.1🛡️ A+~899 tok30 toolsOnline8ms
SlackSlack (Salesforce)

Slack's hosted remote MCP server. Slack's official remote MCP lets agents search channels, read conversation history, post messages and manage canvases inside your Slack workspace. It is protected by OAuth 2.1; compliant clients complete a browser consent flow with PKCE.

https://mcp.slack.com/mcp
🛡️ Official✓ VerifiedStreamable HTTPOAuth 2.1🛡️ A+~514 tok17 toolsOnline174ms

Todoist's official remote MCP server. Agents can add, complete and search tasks, manage projects and sections over OAuth 2.1.

https://ai.todoist.net/mcp
🛡️ Official✓ VerifiedStreamable HTTPOAuth 2.1🛡️ A+~341 tok6 toolsOnline497ms