remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Enables interaction with HubSpot CRM data, providing tools for managing contacts and companies, creating new entries with duplicate checking, and accessing recent engagement history from the CRM.

Servidor MCP de HubSpot

Descripción general

Una implementación de servidor del Protocolo de Contexto de Modelo (MCP) que proporciona integración con HubSpot CRM. Este servidor permite que los modelos de IA interactúen con los datos y las operaciones de HubSpot a través de una interfaz estandarizada.

Para obtener más información sobre el Protocolo de contexto de modelo y cómo funciona, consulte la documentación MCP de Anthropic .

Componentes

Recursos

El servidor expone los siguientes recursos:

hubspot://hubspot_contacts : un recurso dinámico que proporciona acceso a los contactos de HubSpot
hubspot://hubspot_companies : Un recurso dinámico que brinda acceso a las empresas de HubSpot
hubspot://hubspot_recent_engagements : un recurso dinámico que brinda acceso a las interacciones de HubSpot de los últimos 3 días

Todos los recursos se actualizan automáticamente a medida que se modifican sus respectivos objetos en HubSpot.

Ejemplos de indicaciones

Crea contactos de Hubspot copiando desde la página web del perfil de LinkedIn:
Create HubSpot contacts and companies from following: John Doe Software Engineer at Tech Corp San Francisco Bay Area • 500+ connections Experience Tech Corp Software Engineer Jan 2020 - Present · 4 yrs San Francisco, California Previous Company Inc. Senior Developer 2018 - 2020 · 2 yrs Education University of California, Berkeley Computer Science, BS 2014 - 2018
Conozca las últimas actividades de su empresa:
What's happening latestly with my pipeline?

Herramientas

El servidor ofrece varias herramientas para administrar objetos de HubSpot:

Herramientas de gestión de contactos

hubspot_get_contacts
- Recuperar contactos de HubSpot
- No se requiere entrada
- Devuelve: Matriz de objetos de contacto
hubspot_create_contact
- Crear un nuevo contacto en HubSpot (verifica si hay duplicados antes de la creación)
- Aporte:
  - firstname (cadena): Nombre del contacto
  - lastname (cadena): apellido del contacto
  - email (cadena, opcional): dirección de correo electrónico del contacto
  - properties (dict, opcional): Propiedades de contacto adicionales
    - Ejemplo: {"phone": "123456789", "company": "HubSpot"}
- Comportamiento:
  - Comprueba si existen contactos con el mismo nombre y apellido
  - Si se proporciona company en las propiedades, también se verifican coincidencias con la misma empresa
  - Devuelve los detalles de contacto existentes si se encuentra una coincidencia
  - Crea un nuevo contacto solo si no se encuentra ninguna coincidencia

Herramientas de gestión empresarial

hubspot_get_companies
- Recuperar empresas de HubSpot
- No se requiere entrada
- Devuelve: Matriz de objetos de la empresa
hubspot_create_company
- Crear una nueva empresa en HubSpot (verifica si hay duplicados antes de la creación)
- Aporte:
  - name (cadena): nombre de la empresa
  - properties (dict, opcional): Propiedades adicionales de la empresa
    - Ejemplo: {"domain": "example.com", "industry": "Technology"}
- Comportamiento:
  - Comprueba si existen empresas con el mismo nombre
  - Devuelve los detalles de la empresa existente si se encuentra una coincidencia
  - Crea una nueva empresa solo si no se encuentra ninguna coincidencia
hubspot_get_company_activity
- Obtener el historial de actividad de una empresa específica
- Aporte:
  - company_id (cadena): ID de la empresa de HubSpot
- Devuelve: Matriz de objetos de actividad

Herramientas de participación

hubspot_get_recent_engagements
- Obtenga las interacciones de HubSpot de todas las empresas y contactos de los últimos 3 días
- No se requiere entrada
- Devoluciones: Matriz de objetos de interacción con metadatos completos

Soporte multiusuario

Este servidor MCP está diseñado para funcionar con varios usuarios de HubSpot, cada uno con su propio token de acceso. El servidor no utiliza una variable de entorno global para el token de acceso.

En su lugar, cada solicitud al servidor MCP debe incluir el token de acceso específico del usuario de una de las siguientes maneras:

En el encabezado de la solicitud: X-HubSpot-Access-Token: your-token-here
En el cuerpo de la solicitud como accessToken : {"accessToken": "your-token-here"}
En el cuerpo de la solicitud como hubspotAccessToken : {"hubspotAccessToken": "your-token-here"}

Este diseño le permite almacenar tokens de usuario en su propio backend (por ejemplo, Supabase) y pasarlos junto con cada solicitud.

Ejemplo de integración multiusuario

// Example of how to use this MCP server in a multi-user setup
async function makeHubSpotRequest(userId, action, params) {
  // Retrieve the user's HubSpot token from your database
  const userToken = await getUserHubSpotToken(userId); 

  // Make request to MCP server with the user's token
  const response = await fetch('https://your-mcp-server.vercel.app/', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-HubSpot-Access-Token': userToken
    },
    body: JSON.stringify({
      action,
      ...params
    })
  });
  
  return await response.json();
}

Configuración

Prerrequisitos

Necesitarás un token de acceso de HubSpot para cada usuario. Puedes obtenerlo de la siguiente manera:

Cómo crear una aplicación privada en tu cuenta de HubSpot: sigue la Guía de aplicaciones privadas de HubSpot
- Ve a la configuración de tu cuenta de HubSpot
- Vaya a Integraciones > Aplicaciones privadas
- Haga clic en "Crear aplicación privada".
- Complete la información básica:
  - Ponle nombre a tu aplicación
  - Añadir descripción
  - Subir logotipo (opcional)
- Definir los alcances requeridos:
  - oauth (obligatorio)
- Ámbitos opcionales:
  - crm.dealsplits.lectura_escritura
  - crm.objects.companies.read
  - crm.objects.companies.write
  - crm.objects.contacts.read
  - crm.objects.contacts.write
  - crm.objects.deals.read
- Revisar y crear la aplicación
- Copiar el token de acceso generado

Nota: mantenga su token de acceso seguro y nunca lo comprometa con el control de versiones.

Instalación de Docker

Puedes crear la imagen localmente o descargarla de Docker Hub. La imagen está diseñada para la plataforma Linux.

Plataformas compatibles

Linux/amd64
Linux/arm64
Linux/arm/v7

Opción 1: Extraer desde Docker Hub

docker pull buryhuang/mcp-hubspot:latest

Opción 2: Construir localmente

docker build -t mcp-hubspot .

Ejecute el contenedor:

docker run \
  buryhuang/mcp-hubspot:latest

Publicación multiplataforma

Para publicar la imagen de Docker en varias plataformas, puede usar el comando docker buildx . Siga estos pasos:

Cree una nueva instancia de constructor (si aún no lo ha hecho):
docker buildx create --use
Construya y envíe la imagen para múltiples plataformas :
docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t buryhuang/mcp-hubspot:latest --push .
Verifique que la imagen esté disponible para las plataformas especificadas :
docker buildx imagetools inspect buryhuang/mcp-hubspot:latest

Uso con Claude Desktop

Instalación mediante herrería

Para instalar mcp-hubspot para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli@latest install mcp-hubspot --client claude

Uso de Docker

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "buryhuang/mcp-hubspot:latest"
      ]
    }
  }
}

Desarrollo

Para configurar el entorno de desarrollo:

pip install -e .

Licencia

Este proyecto está licenciado bajo la licencia MIT.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Un servidor que permite que los modelos de IA interactúen con los datos y las operaciones de HubSpot CRM a través de una interfaz estandarizada, lo que respalda la gestión de contactos y empresas con autenticación basada en tokens multiusuario.

HubSpot MCP Server