MCP de HubSpot

Una implementación del Protocolo de Contexto de Modelo (MCP) para la API de HubSpot , que proporciona una interfaz estandarizada para acceder y administrar datos de CRM.

Características

Cobertura completa de la API de HubSpot CRM
Soporte para todos los objetos CRM estándar (empresas, contactos, ofertas, etc.)
Gestión avanzada de asociaciones con CRM Associations v4
Puntos finales específicos de la empresa con validación de propiedades
Operaciones por lotes para una gestión eficiente de datos
Capacidades avanzadas de búsqueda y filtrado
Validación de parámetros de tipo seguro con Zod

Instalación

⚠️ NOTA: Debido a la gran cantidad de puntos finales disponibles en este servidor, se recomienda que instale y configure Heimdall para limitar la cantidad de puntos finales expuestos a sus aplicaciones cliente.

Si no tiene una clave API, siga los pasos aquí para obtener un token de acceso.

NPX (Recomendado)

Agregue lo siguiente a su cliente MCP config.json ( ~/.heimdall/config.json si usa Heimdall):

{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": [
        "@shinzolabs/hubspot-mcp"
      ],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "your-token-here"
      }
    }
  }
}

Descarga manual

Descargar el repositorio:

git clone https://github.com/shinzo-labs/hubspot-mcp.git

Instalar paquetes (dentro del repositorio clonado):

pnpm i

Agregue lo siguiente a su cliente MCP config.json ( ~/.heimdall/config.json si usa Heimdall):

{
  "mcpServers": {
    "hubspot": {
      "command": "node",
      "args": [
        "/path/to/hubspot-mcp/index.js"
      ],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "your-token-here"
      }
    }
  }
}

Herrería

Para instalar Claude Desktop automáticamente a través de Smithery :

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

Operaciones de API

Objetos principales de CRM

Operaciones básicas de objetos

crm_list_objects : Lista de objetos CRM con filtrado y paginación opcionales
crm_get_object : Obtener un único objeto CRM por ID
crm_create_object : Crea un nuevo objeto CRM
crm_update_object : Actualizar un objeto CRM existente
crm_delete_object : Eliminar un objeto CRM

Operaciones de búsqueda y por lotes

crm_search_objects : busca objetos de CRM mediante filtros avanzados
crm_batch_create_objects : crea varios objetos en una sola solicitud
crm_batch_update_objects : Actualizar varios objetos en una sola solicitud
crm_batch_delete_objects : eliminar varios objetos en una sola solicitud

Gestión de registros CRM

Empresas

Operaciones básicas:
- crm_create_company : Crea una nueva empresa con propiedades validadas
- crm_update_company : Actualizar una empresa existente
- crm_get_company : Obtener una sola empresa por ID
- crm_search_companies : Busca empresas con filtros específicos
Operaciones por lotes:
- crm_batch_create_companies : Crea varias empresas en una sola solicitud
- crm_batch_update_companies : Actualizar varias empresas en una sola solicitud
Administración de propiedades:
- crm_get_company_properties : Obtener todas las propiedades de la empresa disponibles
- crm_create_company_property : Crea una nueva propiedad de la empresa

Contactos

Operaciones básicas:
- crm_create_contact : Crea un nuevo contacto con propiedades validadas
- crm_update_contact : Actualizar la información de un contacto existente
- crm_get_contact : Obtener un solo contacto por ID
- crm_search_contacts : Busca contactos con filtros específicos
Operaciones por lotes:
- crm_batch_create_contacts : Crea múltiples contactos en una sola solicitud
- crm_batch_update_contacts : Actualizar varios contactos en una sola solicitud
Administración de propiedades:
- crm_get_contact_properties : Obtener todas las propiedades de contacto disponibles
- crm_create_contact_property : Crea una nueva propiedad de contacto

Dirige

Operaciones básicas:
- crm_create_lead : Crea un nuevo cliente potencial con propiedades validadas
- crm_update_lead : Actualizar la información de un cliente potencial existente
- crm_get_lead : Obtener un solo cliente potencial por ID
- crm_search_leads : busca clientes potenciales con filtros específicos
Operaciones por lotes:
- crm_batch_create_leads : crea varios clientes potenciales en una sola solicitud
- crm_batch_update_leads : Actualizar varios clientes potenciales en una sola solicitud
Administración de propiedades:
- crm_get_lead_properties : Obtener todas las propiedades de clientes potenciales disponibles
- crm_create_lead_property : Crea una nueva propiedad de cliente potencial

Gestión del compromiso

Detalles del compromiso

Operaciones básicas:
- engagement_details_get : Obtener detalles de un compromiso específico
- engagement_details_create : Crea un nuevo compromiso
- engagement_details_update : Actualizar un compromiso existente
- engagement_details_delete : Eliminar un compromiso
- engagement_details_list : Lista todos los compromisos con filtrado
- engagement_details_get_associated : Obtener interacciones asociadas

Llamadas

Operaciones básicas:
- calls_create : Crea un nuevo registro de llamada
- calls_get : Obtener detalles de la llamada
- calls_update : Actualizar un registro de llamadas
- calls_archive : Archivar una llamada
- calls_list : Lista todas las llamadas
- calls_search : Buscar llamadas
Operaciones por lotes:
- calls_batch_create : Crea múltiples llamadas
- calls_batch_read : Leer múltiples llamadas
- calls_batch_update : Actualizar múltiples llamadas
- calls_batch_archive : Archivar múltiples llamadas

Correos electrónicos

Operaciones básicas:
- emails_create : Crea un nuevo registro de correo electrónico
- emails_get : Obtener detalles del correo electrónico
- emails_update : Actualizar un correo electrónico
- emails_archive : Archivar un correo electrónico
- emails_list : Lista todos los correos electrónicos
- emails_search : Buscar correos electrónicos
Operaciones por lotes:
- emails_batch_create : Crea varios correos electrónicos
- emails_batch_read : Leer varios correos electrónicos
- emails_batch_update : Actualizar varios correos electrónicos
- emails_batch_archive : Archivar varios correos electrónicos

Reuniones

Operaciones básicas:
- meetings_create : Crear una nueva reunión
- meetings_get : Obtener detalles de la reunión
- meetings_update : Actualizar una reunión
- meetings_delete : Eliminar una reunión
- meetings_list : Lista todas las reuniones
- meetings_search : Buscar reuniones
Operaciones por lotes:
- meetings_batch_create : Crea múltiples reuniones
- meetings_batch_update : Actualizar varias reuniones
- meetings_batch_archive : Archivar varias reuniones

Notas

Operaciones básicas:
- notes_create : Crea una nueva nota
- notes_get : Obtener detalles de la nota
- notes_update : Actualizar una nota
- notes_archive : Archivar una nota
- notes_list : Lista todas las notas
- notes_search : Buscar notas
Operaciones por lotes:
- notes_batch_create : Crea múltiples notas
- notes_batch_read : Leer varias notas
- notes_batch_update : Actualizar varias notas
- notes_batch_archive : Archivar varias notas

Tareas

Operaciones básicas:
- tasks_create : Crea una nueva tarea
- tasks_get : Obtener detalles de la tarea
- tasks_update : Actualizar una tarea
- tasks_archive : Archivar una tarea
- tasks_list : Lista todas las tareas
- tasks_search : Buscar tareas
Operaciones por lotes:
- tasks_batch_create : Crea múltiples tareas
- tasks_batch_read : Leer múltiples tareas
- tasks_batch_update : Actualizar múltiples tareas
- tasks_batch_archive : Archivar múltiples tareas

Asociaciones y relaciones

Asociaciones CRM v4

Operaciones básicas:
- crm_list_association_types : Lista de tipos de asociación disponibles
- crm_get_associations : Obtener todas las asociaciones entre objetos
- crm_create_association : Crear una asociación
- crm_delete_association : Eliminar una asociación
Operaciones por lotes:
- crm_batch_create_associations : Crea múltiples asociaciones
- crm_batch_delete_associations : eliminar múltiples asociaciones

Preferencias de comunicación

Gestión de suscripciones

Operaciones básicas:
- communications_get_preferences : Obtener preferencias de contacto
- communications_update_preferences : Actualizar las preferencias de contacto
- communications_unsubscribe_contact : Cancelación de suscripción global
- communications_subscribe_contact : Suscripción global
- communications_get_subscription_definitions : Obtener definiciones de suscripción
Operaciones masivas:
- communications_get_subscription_status : Obtener el estado de varios contactos
- communications_update_subscription_status : Actualizar el estado de varios contactos

Contribuyendo

Se agradecen y animamos las contribuciones. Para cualquier pregunta, comentario o inquietud, contacte con austin@shinzolabs.com .

HubSpot MCP

Integrations