HubSpot MCP Server

What is HubSpot MCP Server?

HubSpot MCP Server is an open-source MCP server that enables Claude to interact with the HubSpot CRM API for sales analysis and insights. It provides tools to manage contacts, deals, and companies, as well as analytics on pipelines, performance, and forecasts.

How to use HubSpot MCP Server?

Create a HubSpot Private App with the required scopes, copy your private app token, then configure Claude Desktop by adding the server to claude_desktop_config.json using either npx or Docker, setting the HUBSPOT_API_KEY environment variable.

Key features of HubSpot MCP Server

• Search, get, create, and update HubSpot contacts
• List, get, create, and update deals with pagination
• List and get companies with detailed properties
• Retrieve aggregated sales analytics by time period
• View deal history, notes, and engagement activities
• Analyze pipeline conversion and forecast future sales

Use cases of HubSpot MCP Server

• Search for and update contact records in HubSpot CRM
• Create and manage deals with full property support
• Analyze sales performance and pipeline conversion rates
• Retrieve historical changes and notes on deals
• Forecast future sales based on pipeline and past data

FAQ from HubSpot MCP Server

What scopes must my HubSpot Private App include?

The required scopes include crm.objects.contacts.read, crm.objects.contacts.write, crm.objects.deals.read, crm.objects.deals.write, crm.objects.companies.read, crm.objects.companies.write, crm.objects.owners.read, and several schema scopes for contacts, deals, companies, and custom objects. See the full list in the README.

How do I configure the server with Claude Desktop?

Add the server to your claude_desktop_config.json using either npx (specifying @modelcontextprotocol/server-hubspot) or Docker, and provide your HUBSPOT_API_KEY in the environment variables.

What should I do if I encounter errors?

Verify that all required scopes are added to your HubSpot private app, the API key is correctly copied to your configuration, and your HubSpot plan includes access to the APIs you are trying to use.

Is this server affiliated with HubSpot?

No, this open‑source project is not affiliated with or endorsed by HubSpot. It is an independent implementation that interacts with HubSpot's API.

Does the server require any runtime beyond Node.js?

It can be run via npx (which requires Node.js) or Docker, both using the HUBSPOT_API_KEY environment variable. The Docker image is available as mcp/hubspot.