HubSpot MCP Server

@scopiousdigital

About HubSpot MCP Server

mcp server for interacting with HubSpot

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.

Frequently asked questions

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`.

Comments

Basic information

More Data & Analytics MCP servers

mcp-simple-arxiv

andybrandt

Tool to work with arXiv, provide LLM with ability to search and read papers from there

199

MCP Simple PubMed

andybrandt

MCP server for searching and querying PubMed medical papers/research database

168

HubSpot MCP Server

baryhuang

A Model Context Protocol (MCP) server that enables AI assistants to interact with HubSpot CRM data, providing built-in vector storage and caching mechanisms help overcome HubSpot API limitations while improving response times.

128

Salesforce MCP Server

tsmztech

Salesforce MCP Server

161

Bright Data MCP

brightdata

A powerful Model Context Protocol (MCP) server that provides an all-in-one solution for public web access.

2.5K