Hubspot Mcp Server

Created By

DidelotK8 months ago

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

Overview Content Tools Comments

Content

HubSpot MCP Server

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

🚀 Quick Start

# Installation
git clone <repo-url>
cd hubspot-mcp-server
uv sync

# Configuration
export HUBSPOT_API_KEY="your_api_key"

# Start
uv run python main.py --mode stdio

📚 Documentation

Section	Description
Installation	Installation and configuration guide
Integration	Configuration with Claude Desktop and other MCP clients
API Reference	Complete documentation of the 8 available tools
Examples	Use cases and example conversations with Claude
Contributing	Guide for developing new tools

🧪 Practical Examples

Example	Description
Basic Test	Python script to test the MCP server with a client

🛠️ Available Tools

Tool	Description
`list_hubspot_contacts`	List and filter HubSpot contacts
`list_hubspot_companies`	List and filter HubSpot companies
`list_hubspot_deals`	List and filter HubSpot deals
`create_deal`	Create a new deal in HubSpot
`get_deal_by_name`	Search for a deal by exact name
`get_hubspot_contact_properties`	Retrieve contact field properties with types and descriptions
`get_hubspot_company_properties`	Retrieve company field properties with types and descriptions
`get_hubspot_deal_properties`	Retrieve deal field properties with types and descriptions

⚡ Usage with Claude

Once configured, use natural language phrases:

"List my HubSpot contacts"
"Find tech sector companies"
"Show current deals"
"Create a new deal for Project X"
"Search for the 'Project X' deal"
"What contact properties are available?"

🧪 Testing and Quality

# Run tests
uv run pytest

# Code coverage
uv run pytest --cov=src --cov-report=html

Current Status: ✅ 79 tests passed, 96% coverage

📋 Prerequisites

Python 3.12+
uv (package manager)
HubSpot API key with CRM permissions

🤝 Contributing

Check the contributing guide for:

Development standards
Tool creation process
Code and testing conventions
Git workflow and semantic versioning

📄 License

[Project License]

Useful Links:

Server Config

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

Recommend Servers

TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.

Baidu Map百度地图核心API现已全面兼容MCP协议，是国内首家兼容MCP协议的地图服务商。

Serper MCP ServerA Serper MCP Server

Tavily Mcp

WindsurfThe new purpose-built IDE to harness magic

Visual Studio Code - Open Source ("Code - OSS")Visual Studio Code

MiniMax MCPOfficial MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.

Zhipu Web SearchZhipu Web Search MCP Server is a search engine specifically designed for large models. It integrates four search engines, allowing users to flexibly compare and switch between them. Building upon the web crawling and ranking capabilities of traditional search engines, it enhances intent recognition capabilities, returning results more suitable for large model processing (such as webpage titles, URLs, summaries, site names, site icons, etc.). This helps AI applications achieve "dynamic knowledge acquisition" and "precise scenario adaptation" capabilities.

DeepChatYour AI Partner on Desktop

Jina AI MCP ToolsA Model Context Protocol (MCP) server that integrates with Jina AI Search Foundation APIs.

BlenderBlenderMCP connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. This integration enables prompt assisted 3D modeling, scene creation, and manipulation.