Hubspot Mcp Server

Name: Hubspot Mcp Server
Author: DidelotK

@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

Basic information

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.

Comments

More Data & Analytics MCP servers

Google Ads MCP

cohnen

An MCP tool that connects Google Ads with Claude AI/Cursor and others, allowing you to analyze your advertising data through natural language conversations. This integration gives you access to campaign information, performance metrics, keyword analytics, and ad management—all th

657