MMCPMarkets
BM

baryhuang/mcp-hubspot

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

129 stars 64 forks Качество 70 Тренд 16MIT
Repository Install

baryhuang/mcp-hubspot — это кандидат на MCP-сервер, импортированный из https://github.com/baryhuang/mcp-hubspot.

Обзор

baryhuang/mcp-hubspot — это кандидат на MCP-сервер, импортированный из https://github.com/baryhuang/mcp-hubspot.

Обзор (машинный перевод)

Обзор

Сервер Model Context Protocol (MCP), который позволяет ассистентам ИИ взаимодействовать с данными CRM HubSpot. Этот сервер соединяет модели ИИ с вашей учётной записью HubSpot, обеспечивая прямой доступ к контактам, компаниям и данным взаимодействия. Встроенные механизмы векторного хранения и кэширования помогают преодолеть ограничения API HubSpot, одновременно улучшая время отклика.

Наша реализация отдаёт приоритет самым часто используемым и ценным операциям HubSpot с надёжной обработкой ошибок и стабильностью API. Каждый компонент оптимизирован для дружественных к ИИ взаимодействия, обеспечивая надёжную производительность даже при сложных многоступенчатых рабочих процессах CRM.

Почему MCP-HubSpot?

  • Прямой доступ к CRM: Подключите Claude и других AI-ассистентов к вашим данным HubSpot без промежуточных шагов
  • Удержание контекста: Векторное хранение с FAISS позволяет семантический поиск по предыдущим взаимодействиям
  • Zero Configuration: Простое развертывание Docker с минимальной настройкой

Примеры запросов

Доступные инструменты

Сервер предлагает инструменты для управления и поиска данных HubSpot:

Инструмент Назначение
hubspot_create_contact Создание контактов с предотвращением дублирования

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального 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:

Открыть полный README на GitHub

Установка

docker run -i --rm -e HUBSPOT_ACCESS_TOKEN=your_token -v /path/to/storage:/storage # Optional persistent storage "buryhuang/mcp-hubspot:latest
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "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" ] } } }