Does HubSpot provide more than one MCP server?
Yes. HubSpot documents a remote CRM MCP server and a separate local Developer MCP server.
CRMFreeactiveReviewed by MCPIndex
HubSpot MCP Server
Connects AI clients to HubSpot CRM contacts, companies, deals, engagements, and developer workflows.
Looking for more MCP servers? Browse the full MCP tools directory or explore more tools in CRM.
Quick overview
HubSpot MCP is a CRM control surface, not a simple contact lookup. The remote server can provide read and write access to contacts, companies, deals, engagements, and related objects, while the developer MCP server is a separate local CLI-based surface for HubSpot Developer Platform work. That distinction is the architecture: CRM data and developer-platform administration must not be treated as interchangeable permissions. A natural-language request to “update this deal” can alter pipeline state, ownership, stage, forecast, lifecycle history, and downstream automation, so the agent needs object ID, portal, object type, property name, association context, and permission scope before writing. Use HubSpot's OAuth-backed remote endpoint for CRM data, grant only the scopes required, separate read from write sessions, and require a diff before any record mutation. A silent failure occurs when the OAuth session is valid but points to a different HubSpot portal, user-level application, or object scope; the response looks correct while describing an unintended CRM context. Require portal ID, OAuth application, user identity, object type, record ID, and property scope in every preflight response. HubSpot MCP is strongest when CRM operations remain auditable and portal-scoped rather than becoming invisible side effects of conversational automation.
What this MCP server is best for
- HubSpot MCP Server is useful when you want to extend an AI assistant with real tools and live system access.
- It helps move from chat-only answers to real actions such as reading data, managing systems, or retrieving current information.
- It is best for developer and technical workflows where AI needs controlled access to external tools or services.
When to choose it
Choose HubSpot MCP Server when you want an MCP server focused on CRM and need tighter integration with your existing tools.
Good fit
hubspotcrmsalesmarketingcustomer-data
HubSpot MCP Server Configuration
Use the following configuration as a starting point for Claude Desktop or any compatible MCP client, then replace placeholder credentials with your own values.
claude_desktop_config.json
{
"mcpServers": {
"hubspot": {
"url": "https://mcp.hubspot.com/"
}
}
}How to set up HubSpot MCP Server
These setup steps cover the typical installation flow for this MCP server.
- 1
Choose the correct HubSpot MCP surface: the remote CRM server or the local developer MCP server.
- 2
Create a user-level HubSpot application on the new Developer Platform and grant only the CRM scopes required.
- 3
Configure the remote MCP endpoint and authenticate through OAuth.
- 4
Verify portal ID, user identity, scopes, and object access before retrieving or updating CRM data.
- 5
Test read-only contact, company, deal, and engagement queries before enabling writes.
- 6
Pro-Tip: Never let an agent write CRM properties without a reviewed diff; require portal ID, object type, record ID, property names, current values, proposed values, and association context before execution.
Frequently asked questions
Common questions for HubSpot MCP Server.
Can HubSpot MCP write CRM records?
Yes, depending on the OAuth scopes and enabled tools. Write operations should require a reviewed diff and clear record and property context.
What is a silent failure in HubSpot MCP?
The session can authenticate to a valid HubSpot portal or application that is not the intended one. Fix it by exposing portal ID, OAuth application, user identity, scopes, object type, and record ID.
How should CRM associations be protected?
Require association type, source object, target object, current association state, and proposed change before creating or deleting associations.
HubSpot MCP Server vs Competitors
| Feature | HubSpot MCP Server | Competitor |
|---|---|---|
| CRM Read/Write | ✅ Supports secure remote access to CRM objects through OAuth | ❌ Generic spreadsheet CRM connectors |
| Portal Scoping | ✅ Uses HubSpot portal, user, application, and scope context | ❌ Shared private-app access tokens |
| Developer Platform | ✅ Provides a separate local Developer MCP surface | ❌ One combined production-admin token |
| Association Awareness | ✅ Can reason over CRM objects and associations | ❌ Flat contact-export automation |