hubspot-mcp MCP Server

MCP Server for the HubSpot API, enabling Claude to interact with HubSpot CRM for sales analysis and insights.

Local serverstdioMIT

What is the hubspot-mcp Server?

hubspot-mcp is an MCP project maintained in the scopiousdigital/hubspot-mcp repository. The maintainer describes its purpose as “MCP Server for the HubSpot API, enabling Claude to interact with HubSpot CRM for sales analysis and insights”. Read the project documentation for the complete scope.

Installation

The documented npm package is @modelcontextprotocol/server-hubspot. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares HUBSPOT_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
countnumber, default: 10): Maximum number of contacts to return
ReturnsForecasted sales metrics for future periods based on historical data and current pipeline
limitnumber, default: 20): Maximum number of engagements to return
numberOfPeriodsnumber, default: 3): Number of future periods to forecast

How to install the hubspot-mcp Server

{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-hubspot"
      ],
      "env": {
        "HUBSPOT_API_KEY": "YOUR_HUBSPOT_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
HUBSPOT_API_KEYDeclared in the maintainer’s client configuration.Check documentation