HubSpot MCP Server

Name: HubSpot MCP Server
Author: scopiousdigital

@scopiousdigital

Repository

About HubSpot MCP Server

mcp server for interacting with HubSpot

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "hubspot-mcp": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "mcp/hubspot",
        "-f",
        "Dockerfile",
        "."
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.