HubSpot MCP

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

Prerrequisitos

Si no tiene una clave API, siga estos pasos para obtener un token de acceso. La compatibilidad con OAuth está prevista como una mejora futura.

Configuración del cliente

Hay varias opciones para configurar el cliente MCP con el servidor. Para la configuración de un servidor alojado/remoto, utilice la CLI de Smithery con una clave API de Smithery . Para la instalación local, utilice npx o compile desde el código fuente. Cada una de estas opciones se explica a continuación.

Servidor remoto de Smithery (recomendado)

Para agregar un servidor remoto a su cliente MCP config.json , ejecute el siguiente comando desde Smithery CLI :

Ingrese su HUBSPOT_ACCESS_TOKEN cuando se le solicite.

SDK de herrería

Si está desarrollando su propia aplicación de agente, puede utilizar el código repetitivo aquí .

Instalación local de NPX

Para instalar el servidor localmente con npx , agregue lo siguiente a su cliente MCP config.json :

Construir desde la fuente

1. Descargar el repositorio:

2. Instalar paquetes (dentro del repositorio clonado):

3. Agregue lo siguiente a su cliente MCP config.json :

Variables de configuración

Herramientas compatibles

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

Productos

Operaciones básicas:

• products_create : crea un producto con las propiedades dadas y devuelve una copia del objeto, incluido el ID.
• products_read : Lee un objeto identificado por ID
• products_update : Realiza una actualización parcial de un objeto identificado por ID. Las propiedades de solo lectura o inexistentes generarán un error. Los valores de las propiedades se pueden borrar pasando una cadena vacía.
• products_archive : Mueve un objeto identificado por ID a la papelera de reciclaje.
• products_list : Lee una página de productos. Controla la información devuelta mediante el parámetro de consulta properties . " after es el token del cursor de paginación del último recurso leído correctamente; se devolverá como la propiedad JSON " paging.next.after " de una respuesta paginada que contenga más resultados.
• products_search : Buscar productos

Operaciones por lotes:

• products_batch_create : Crea un lote de productos
• products_batch_read : Lee un lote de productos por ID interno o valores de propiedad únicos. Recupera registros por el parámetro idProperty para recuperar registros por una propiedad de valor único personalizada.
• products_batch_update : actualiza un lote de productos por ID interno o valores únicos especificados por el parámetro de consulta idProperty .
• products_batch_archive : Archivar un lote de productos por ID

Contribuyendo

¡Se agradecen y animamos las contribuciones! Consulte CONTRIBUTING.md para obtener información sobre problemas, contribuciones e información de contacto.