HubSpot MCP Server

HubSpot MCP Server

Descripción general

Un servidor de Model Context Protocol (MCP) que permite a los asistentes de IA interactuar con los datos de HubSpot CRM. Este servidor conecta los modelos de IA con tu cuenta de HubSpot, proporcionando acceso directo a contactos, empresas y datos de interacción. El almacenamiento vectorial integrado y los mecanismos de caché ayudan a superar las limitaciones de la API de HubSpot mientras mejoran los tiempos de respuesta.

Nuestra implementación prioriza las operaciones de HubSpot más utilizadas y de mayor valor, con un manejo robusto de errores y estabilidad de la API. Cada componente está optimizado para interacciones amigables con la IA, garantizando un rendimiento fiable incluso durante flujos de trabajo CRM complejos de varios pasos.

¿Por qué MCP-HubSpot?

• Acceso directo al CRM: Conecta Claude y otros asistentes de IA a tus datos de HubSpot sin pasos intermedios
• Retención de contexto: El almacenamiento vectorial con FAISS permite la búsqueda semántica en interacciones anteriores
• Configuración cero: Implementación sencilla con Docker y configuración mínima

Ejemplos de prompts

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

What's happening lately with my pipeline?

Herramientas disponibles

El servidor ofrece herramientas para la gestión de HubSpot y la recuperación de datos:

Herramienta	Propósito
hubspot_create_contact	Crear contactos con prevención de duplicados
hubspot_create_company	Crear empresas con prevención de duplicados
hubspot_get_company_activity	Recuperar actividad de empresas específicas
hubspot_get_active_companies	Recuperar las empresas más recientemente activas
hubspot_get_active_contacts	Recuperar los contactos más recientemente activos
hubspot_get_recent_conversations	Recuperar hilos de conversación recientes con mensajes
hubspot_search_data	Búsqueda semántica en datos de HubSpot previamente recuperados

Características de rendimiento

• Almacenamiento vectorial: Utiliza FAISS para una búsqueda y recuperación semántica eficiente
• Indexación a nivel de hilo: Almacena cada hilo de conversación individualmente para una recuperación precisa
• Caché de incrustaciones: Utiliza SentenceTransformer con caché automática
• Almacenamiento persistente: Los datos persisten entre sesiones en un directorio de almacenamiento configurable
• Soporte multiplataforma: Imágenes Docker optimizadas para varias arquitecturas

Configuración

Requisitos previos

Necesitarás un token de acceso de HubSpot con estos alcances:

• crm.objects.contacts (lectura/escritura)
• crm.objects.companies (lectura/escritura)
• sales-email-read

Inicio rápido

# 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

Configuración de Docker

Para configuración manual en 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"
      ]
    }
  }
}

Creación de la imagen Docker

Para crear la imagen Docker localmente:

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

Para compilaciones multiplataforma:

docker buildx create --use
docker buildx build --platform linux/amd64,linux/arm64 -t buryhuang/mcp-hubspot:latest --push .

Desarrollo

pip install -e .

Licencia

Licencia MIT