Development · MODEL CONTEXT PROTOCOL

mcp-hubspot

An MCP server implementation that seamlessly connects Claude and other AI models to HubSpot CRM data. Provides tools for managing contacts, companies, and engagement activities through standardized interfaces. Simplifies contact creation, duplicate detection, and pipeline management with minimal configuration.

打开来源所有 MCP 服务器

连接能力

mcp-hubspot 为 AI Agent 提供什么

来源目录未提供结构化功能列表，请在使用前阅读源仓库文档。

安全

MCP 收录不等于安全审核

MCP 服务器可能获得模型上下文、凭据、本地文件或调用外部系统的权限。连接 Agent 前，请检查代码、环境变量、网络行为、软件包来源与维护状态。

README

仓库文档

HubSpot MCP Server

Overview

A Model Context Protocol (MCP) server that enables AI assistants to interact with HubSpot CRM data. This server bridges AI models with your HubSpot account, providing direct access to contacts, companies, and engagement data. Built-in vector storage and caching mechanisms help overcome HubSpot API limitations while improving response times.

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

Why MCP-HubSpot?

Direct CRM Access: Connect Claude and other AI assistants to your HubSpot data without intermediary steps
Context Retention: Vector storage with FAISS enables semantic search across previous interactions
Zero Configuration: Simple Docker deployment with minimal setup

Example Prompts

Create HubSpot contacts and companies from this LinkedIn profile:
[Paste LinkedIn profile text]

What's happening lately with my pipeline?

Available Tools

The server offers tools for HubSpot management and data retrieval:

Tool	Purpose
`hubspot_create_contact`	Create contacts with duplicate prevention
`hubspot_create_company`	Create companies with duplicate prevention
`hubspot_get_company_activity`	Retrieve activity for specific companies
`hubspot_get_active_companies`	Retrieve most recently active companies
`hubspot_get_active_contacts`	Retrieve most recently active contacts
`hubspot_get_recent_conversations`	Retrieve recent conversation threads with messages
`hubspot_search_data`	Semantic search across previously retrieved HubSpot data

Performance Features

Vector Storage: Utilizes FAISS for efficient semantic search and retrieval
Thread-Level Indexing: Stores each conversation thread individually for precise retrieval
Embedding Caching: Uses SentenceTransformer with automatic caching
Persistent Storage: Data persists between sessions in configurable storage directory
Multi-platform Support: Optimized Docker images for various architectures

Setup

Prerequisites

You'll need a HubSpot access token with these scopes:

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

Quick Start

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

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

Docker Configuration

For manual configuration 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"
      ]
    }
  }
}

Building 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 -t buryhuang/mcp-hubspot:latest --push .

Development

pip install -e .

License

MIT License

在 GitHub 查看 README

社区

收藏、评分与讨论

正在载入社区数据…