Hubspot Mcp Server

@DidelotK

About Hubspot Mcp Server

MCP server for integrating HubSpot with Claude Desktop and other MCP clients. Provides access to HubSpot contacts, companies, and deals through conversational tools.

#hubspot #mcp #integration

Config

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

{
  "mcpServers": {
    "hubspot": {
      "command": "uv",
      "args": [
        "run",
        "python",
        "/path/to/your/project/main.py",
        "--mode",
        "stdio"
      ],
      "env": {
        "HUBSPOT_API_KEY": "your_hubspot_api_key"
      }
    }
  }
}

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?

It is an MCP (Model Context Protocol) server that integrates HubSpot with Claude Desktop and other MCP clients. It provides conversational access to HubSpot contacts, companies, and deals through a set of tools.

How to use HubSpot MCP Server?

Install by cloning the repository and running uv sync. Configure by setting the HUBSPOT_API_KEY environment variable. Start the server with uv run python main.py --mode stdio. Then configure Claude Desktop or another MCP client using the integration guide.

Key features of HubSpot MCP Server

List and filter HubSpot contacts.
List and filter HubSpot companies.
List and filter HubSpot deals.
Create new deals in HubSpot.
Search for a deal by exact name.
Retrieve contact, company, and deal field properties.

Use cases of HubSpot MCP Server

List all HubSpot contacts conversationally in Claude.
Find companies belonging to a specific industry sector.
View current deal pipeline and details.
Create a new deal for a project from a chat.
Search for an existing deal by its name.

FAQ from HubSpot MCP Server

What are the prerequisites for using HubSpot MCP Server?

Python 3.12+, the uv package manager, and a HubSpot API key with CRM permissions are required.

How do I install and run the server?

Clone the repository, run uv sync, export the HUBSPOT_API_KEY environment variable, and execute uv run python main.py --mode stdio.

What tools does HubSpot MCP Server provide?

It provides 8 tools: list contacts, list companies, list deals, create a deal, get a deal by name, and get contact/company/deal properties.

How can I use it with Claude Desktop?

After running the server, configure Claude Desktop to connect to it. You can then use natural language phrases like “List my HubSpot contacts” or “Create a new deal for Project X.”

What is the current test coverage?

The server has passed 79 tests with 96% code coverage.

Frequently asked questions

What are the prerequisites for using HubSpot MCP Server?

Python 3.12+, the uv package manager, and a HubSpot API key with CRM permissions are required.

How do I install and run the server?

Clone the repository, run `uv sync`, export the `HUBSPOT_API_KEY` environment variable, and execute `uv run python main.py --mode stdio`.

What tools does HubSpot MCP Server provide?

It provides 8 tools: list contacts, list companies, list deals, create a deal, get a deal by name, and get contact/company/deal properties.

How can I use it with Claude Desktop?

After running the server, configure Claude Desktop to connect to it. You can then use natural language phrases like “List my HubSpot contacts” or “Create a new deal for Project X.”

What is the current test coverage?

The server has passed 79 tests with 96% code coverage.

Comments

Basic information

More Data & Analytics MCP servers

Linkly Link Shortener

Linkly

Linkly is an URL shortener with geo redirects, click & conversion tracking, link rotators, mobile deep links and an URL shortening API.

MCP Simple PubMed

andybrandt

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

168

TofuBofu AI Visibility

Arnav Neil

TofuBofu runs a free AI visibility scan for any B2B company, right inside your AI assistant. Ask it to scan a domain and it runs the questions real buyers ask across ChatGPT, Claude, Gemini, Perplexity, Google AI Overvie

Subtext

Subtext by Fullstory

Session replay, built for agents. Subtext is agentic session review: it captures production sessions of your app and connects them to your coding agent — Claude Code, Cursor, Codex, Devin, your own harness — so it can

Rankbits

rankbits

AI visibility analytics across 15+ providers (ChatGPT, Perplexity, Gemini, AI Overviews, and more). The MCP connector lets assistants run scans, compare competitor mentions, and track your brand's visibility in AI answer