MCP Hubspot

🚀 Huya HubSpot MCP Server

A Model Context Protocol (MCP) server enabling AI assistants to interact with HubSpot CRM data. It connects AI models to your HubSpot account, providing direct access to contact, company, and interaction data.

🚀 Quick Start

This is a Model Context Protocol (MCP) server that enables AI assistants to interact with HubSpot CRM data. The server connects AI models to your HubSpot account, providing direct access to contact, company, and interaction data. Built - in vector storage and caching mechanisms overcome HubSpot API limitations and improve response times.

Our implementation prioritizes the most frequently used, high - value HubSpot operations and features robust error handling and API stability. Each component is optimized for AI - friendly interactions, ensuring reliable operation even in complex multi - step CRM workflows.

✨ Features

• Direct CRM Access: Connect Claude and other AI assistants to your HubSpot data without intermediate steps.
• Context Preservation: Use FAISS for semantic search to retrieve information from previous interactions.
• Zero Configuration: Achieve easy installation through simple Docker deployment.

💻 Usage Examples

Basic Usage

Create a HubSpot contact and company from this LinkedIn profile:
[Paste LinkedIn profile text]

What's been happening in my pipeline recently?

📚 Documentation

The server provides the following tools for HubSpot management and data retrieval:

🔧 Technical Details

• Vector Storage: Utilize FAISS for efficient semantic search and retrieval.
• Thread - level Indexing: Store each session separately to ensure precise retrieval.
• Embedding Cache: Use SentenceTransformer and cache automatically.
• Persistent Storage: Persist data between configured storage directories.
• Multi - platform Support: Optimize Docker images for various architectures.

📦 Installation

Prerequisites

You need a HubSpot access token with the following permissions:

• crm.objects.contacts (read and write)
• crm.objects.companies (read and write)
• sales - email - read

Quick Start

# Install via Smithery (recommended)
npx -y @smithery/cli@latest install mcp-hubspot --client claude

# Or pull the Docker image directly
docker run -e HUBSPOT_ACCESS_TOKEN=your_token buryhuang/mcp-hubspot:latest

Docker Configuration

Manually configure in Claude Desktop:

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "HUBSPOT_ACCESS_TOKEN=your_token",
        "-v", "/path/to/storage:/storage",  # Optional persistent storage
        "buryhuang/mcp-hubspot:latest"
      ]
    }
  }
}

Build the Docker Image

To build the Docker image locally:

git clone https://github.com/buryhuang/mcp-hubspot.git
cd mcp-hubspot
docker build -t mcp-hubspot .

For multi - platform builds:

docker buildx create --use
docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 .

📄 License

This project is licensed under the MIT License.