Hubspot Mcp Server

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.