Hubspot MCP Server

🚀 Buryhuang HubSpot MCP Server

A Model Context Protocol (MCP) server that enables AI assistants to interact with HubSpot CRM data.

🚀 Quick Start

A Model Context Protocol (MCP) server enabling AI assistants to interact with HubSpot CRM data. This 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 while improving response speed.

Our implementation prioritizes the most commonly used, high - value HubSpot operations, with 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 span the context of previous interactions.
• Zero Configuration: Simple Docker deployment with minimal setup.

💻 Usage Examples

Basic Usage

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

What's going on in my latest .pipeline?

📚 Documentation

Available Tools

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

Performance Features

• Vector Storage: Use FAISS for efficient semantic search and retrieval.
• Thread - level Indexing: Store each session separately for precise retrieval.
• Embedding Caching: Use SentenceTransformer with automatic caching.
• Persistent Storage: Data persists across sessions in the configured storage directory.
• Multi - platform Support: Optimized 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 .

Usage Instructions

• Run the Server: Run the MCP server via a Docker container:

  docker run -e HUBSPOT_ACCESS_TOKEN=your_token buryhuang/mcp - hubspot:latest
  

• Connect to the Client: Use the HubSpot client library to connect in your application.

📄 License

This software is protected by the MIT license. See the LICENSE file for details.

[](https://hub.docker.com/r/buryhuang/mcp - hubspot)