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.
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.
Basic information
More Data & Analytics MCP servers
AskRentAI
AskRentAIAsk your Rent Manager property portfolio anything, from the AI you already use. AskRentAI is a hosted, read-only MCP server for Rent Manager, the property management platform used across a large share of US rental housi
Hologrow
Hologrow IncHologrow is the e-commerce data layer for any AI
Octolens
OctolensGive your AI agents every brand mention across the internet — 15+ platforms, AI-filtered, one structured feed.
SiteGuru
Your site's real SEO data in your AI assistant. SiteGuru crawls your website and connects to Google Search Console and Google Analytics. This server exposes that data to your assistant, so you can ask what's broken, wha
Rankbits
rankbitsAI 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
Comments