Hubspot Mcp Server

Created By

DidelotK6 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.

TimeA Model Context Protocol server that provides time and timezone conversion capabilities. This server enables LLMs to get current time information and perform timezone conversions using IANA timezone names, with automatic system timezone detection.

MCP AdvisorMCP Advisor & Installation - Use the right MCP server for your needs

AiimagemultistyleA Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.

Playwright McpPlaywright MCP server

CursorThe AI Code Editor

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

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

Howtocook Mcp基于Anduin2017 / HowToCook （程序员在家做饭指南）的mcp server，帮你推荐菜谱、规划膳食，解决“今天吃什么“的世纪难题； Based on Anduin2017/HowToCook (Programmer's Guide to Cooking at Home), MCP Server helps you recommend recipes, plan meals, and solve the century old problem of "what to eat today"

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

ChatWiseThe second fastest AI chatbot™