HubSpot MCP Server

Integra con HubSpot CRM para gestionar contactos, negocios y empresas.

GitHubPrueba este MCPPatrocinado

Documentación

🚀 Guía de Inicio Rápido

¡Bienvenido al HubSpot MCP Server! Esta guía te pondrá en funcionamiento en solo unos minutos.

📋 Requisitos Previos

  • Python 3.8+ instalado en tu sistema
  • Claude Desktop aplicación instalada
  • Cuenta de Desarrollador de HubSpot (gratuita)
  • Integración Nango configurada (para autenticación segura)

⚡ Configuración en 5 Minutos

Paso 1: Obtén tu Token de Acceso de HubSpot

  1. Visita Portal de Desarrolladores de HubSpot
  2. Inicia sesión con tu cuenta de HubSpot
  3. Crea una nueva aplicación o selecciona una existente
  4. Ve a la pestaña "Auth" → "Scopes"
  5. Habilita estos scopes: 
    ✅ crm.objects.companies.read
✅ crm.objects.companies.write  
✅ crm.objects.contacts.read
✅ crm.objects.contacts.write
✅ crm.lists.read
✅ crm.lists.write
  6. Copia tu token de acceso desde la pestaña "Auth"

Paso 2: Configura la Integración Nango

Obtén tus credenciales de Nango:

  • NANGO_BASE_URL: La URL base de tu instancia de Nango
  • NANGO_SECRET_KEY: Tu clave secreta de Nango
  • NANGO_CONNECTION_ID: Tu identificador de conexión
  • NANGO_INTEGRATION_ID: Tu identificador de integración

Paso 3: Configura Claude Desktop

Agrega esta configuración al archivo de configuración de Claude Desktop:

macOS:

Ubicación: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

Ubicación: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hubspot": {
      "command": "uvx",
      "args": ["git+https://github.com/Shameerpc5029/hubspot-mcp.git"],
      "env": {
        "NANGO_BASE_URL": "enter_your_nango_base_url_here",
        "NANGO_SECRET_KEY": "enter_your_nango_secret_key_here",
        "NANGO_CONNECTION_ID": "enter_your_nango_connection_id_here",
        "NANGO_INTEGRATION_ID": "enter_your_nango_integration_id_here"
      }
    }
  }
}

Importante: Reemplaza los valores de ejemplo con tus credenciales reales de Nango:

  • Reemplaza enter_your_nango_base_url_here con la URL base de tu Nango
  • Reemplaza enter_your_nango_secret_key_here con tu clave secreta
  • Reemplaza enter_your_nango_connection_id_here con tu ID de conexión
  • Reemplaza enter_your_nango_integration_id_here con tu ID de integración

Paso 4: Reinicia Claude Desktop

Cierra y vuelve a abrir Claude Desktop para cargar la nueva configuración.

✅ Probando tu Configuración

En Claude, prueba estos comandos:

  1. Prueba de conexión: "Lista todas las empresas en mi HubSpot"
  2. Crea una empresa de prueba: "Crea una empresa llamada Test Corp con dominio test.com"
  3. Busca contactos: "Encuentra todos los contactos con direcciones de correo de gmail"

🎯 Lo Que Puedes Hacer Ahora

Gestión de Empresas

  • Crear, actualizar y eliminar empresas
  • Buscar por dominio u otros criterios
  • Obtener actividad reciente de empresas
  • Operaciones masivas con filtros

Gestión de Contactos

  • Crear, actualizar y eliminar contactos
  • Buscar por correo electrónico, nombre, teléfono
  • Gestionar membresías en listas
  • Rastrear actividad reciente de contactos

Ejemplos de Lenguaje Natural

  • "Crea una empresa para Acme Corp con su sitio web acme.com"
  • "Encuentra el contacto john@example.com y actualiza su número de teléfono"
  • "Muéstrame todas las empresas creadas este mes"
  • "Agrega el contacto ID 12345 a mi lista de clientes VIP"

🔧 Solución de Problemas

Problemas Comunes

❌ Errores de "Herramienta no encontrada"

  • Reinicia Claude Desktop después de cambios en la configuración
  • Verifica que tus credenciales de Nango sean correctas
  • Comprueba que uvx esté instalado en tu sistema

❌ Fallos de autenticación

  • Vuelve a verificar tus credenciales de Nango en la configuración
  • Asegúrate de que todos los scopes requeridos estén habilitados en tu aplicación de HubSpot
  • Verifica que tu integración de Nango esté configurada correctamente

❌ Comando uvx no encontrado

  • Instala uvx: pip install uvx o pipx install uvx
  • Asegúrate de que uvx esté en el PATH de tu sistema

Prueba de Conexión

Puedes probar tu configuración haciendo preguntas simples a Claude como:

"Can you connect to my HubSpot account?"
"Show me my recent contacts"
"List my companies"

Modo de Depuración

Si encuentras problemas, revisa los registros de Claude Desktop o la consola para ver mensajes de error.

📞 Obteniendo Ayuda

🎉 ¡Estás Listo!

¡Ahora tienes HubSpot CRM integrado con Claude! Comienza con comandos simples y explora las poderosas posibilidades de automatización.

Características Clave Disponibles:

  • 🏢 Gestión completa de empresas
  • 👥 Creación y actualización de contactos
  • 📋 Gestión de listas
  • 🔍 Capacidades avanzadas de búsqueda
  • 📊 Seguimiento de actividad reciente

¡Feliz automatización! 🚀