Integración HubSpot + Brevo

HubSpot + Brevo

Conecta los datos del CRM de HubSpot a la plataforma de engagement de Brevo. Usa HubSpot como tu fuente de verdad para datos de contactos y tratos, y Brevo para la ejecución de campañas multicanal, email, SMS, WhatsApp.

Servidores MCP Utilizados

ServidorURLAutenticaciónPropósito
HubSpot MCPmcp.hubspot.comOAuth/PKCEDatos CRM: contactos, empresas, tratos, tickets, productos, pedidos (solo lectura)
Brevo MCPmcp.brevo.com/v1/brevo/mcpTokenContactos, email, SMS, WhatsApp, campañas, seguimiento de eventos

Caution

El servidor MCP de HubSpot es actualmente de solo lectura (BETA). Puedes leer datos CRM de HubSpot y usarlos para impulsar acciones en Brevo, pero no puedes escribir de vuelta a HubSpot vía MCP. Para sincronización bidireccional, usa la API REST de HubSpot junto con la conexión MCP.

Configuración

Paso 1: Crear una App Auth MCP de HubSpot

  1. En HubSpot, ve a Development > MCP Auth Apps
  2. Haz clic en Create MCP auth app
  3. Establece tu URL de redirección (para pruebas en Claude Desktop: http://localhost:6274/oauth/callback/debug)
  4. Toma nota de tu Client ID y Client Secret

Paso 2: Conectar Ambos Servidores MCP

Para herramientas que admiten OAuth (Cursor, VS Code):

{
"mcpServers": {
"hubspot": {
"url": "https://mcp.hubspot.com/",
"headers": {
"Authorization": "Bearer your-hubspot-oauth-token"
}
},
"brevo": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.brevo.com/v1/brevo/mcp",
"--header",
"Authorization: Bearer ${BREVO_MCP_TOKEN}"
],
"env": {
"BREVO_MCP_TOKEN": "your-brevo-mcp-token"
}
}
}
}

Tip

HubSpot MCP requiere OAuth con PKCE. Herramientas como Cursor lo manejan de forma nativa. Para Claude Desktop/Code, es posible que necesites obtener un token por separado y pasarlo como token Bearer.

Paso 3: Verificar

> Muéstrame mis tratos de HubSpot en etapa de Negociación
> ¿Cuántos contactos tengo en Brevo?

Caso de Uso 1: Agente de Sincronización de Contactos CRM

Sincroniza contactos de HubSpot a Brevo con enriquecimiento de etapa de trato:

---
name: hubspot-contact-sync
description: Sync HubSpot CRM contacts to Brevo with deal data enrichment
version: 1.0.0
temperature: 0.1
tools:
- hubspot
- brevo_contacts
- brevo_attributes
- brevo_lists
- brevo_segments
triggers:
- schedule: "0 */4 * * *"
---
# HubSpot Contact Sync
Read contacts and associated deal data from HubSpot,
sync to Brevo with enriched attributes for segmentation.
## Strategy
1. Query HubSpot for contacts modified since last sync
2. For each contact, fetch associated deals and company
3. Create/update Brevo contact with enriched data:
- CRM lifecycle stage → Brevo attribute
- Deal amount → Brevo attribute
- Deal stage → Brevo segment
4. Auto-segment in Brevo:
- "SQL" contacts → Sales Qualified list
- "Opportunity" contacts → Active Pipeline list
- "Customer" contacts → Customer list
## Field Mapping
| HubSpot Property | Brevo Attribute |
|-----------------|-----------------|
| email | EMAIL |
| firstname | FIRSTNAME |
| lastname | LASTNAME |
| phone | SMS |
| lifecyclestage | LIFECYCLE_STAGE |
| hs_lead_status | LEAD_STATUS |
| company (associated) | COMPANY |
| deal amount (sum) | DEAL_VALUE |
| deal stage (latest) | DEAL_STAGE |
## Rules
- NEVER sync contacts without email addresses
- ALWAYS preserve existing Brevo data if HubSpot field is empty
- Track sync with events: hubspot_sync_success, hubspot_sync_error
- Log contact count per lifecycle stage for reporting

Caso de Uso 2: Agente de Campaña por Etapa de Trato

Activa campañas de Brevo basadas en cambios en la etapa de tratos de HubSpot:

---
name: hubspot-deal-campaigns
description: Trigger targeted Brevo campaigns when HubSpot deals change stages
version: 1.0.0
temperature: 0.3
tools:
- hubspot
- brevo_contacts
- brevo_email_campaign_management
- brevo_templates
- brevo_segments
triggers:
- schedule: "0 9 * * *"
---
# Deal-Stage Campaign Agent
Monitor HubSpot deal stages and trigger appropriate
engagement campaigns in Brevo.
## Stage-to-Campaign Mapping
| HubSpot Deal Stage | Brevo Action |
|-------------------|--------------|
| Appointment Scheduled | Send meeting prep email with company info |
| Qualified to Buy | Add to "Nurture" drip sequence |
| Presentation Scheduled | Send case study relevant to their industry |
| Decision Maker Bought-In | Send ROI calculator + pricing guide |
| Contract Sent | Send "What to expect" onboarding preview |
| Closed Won | Trigger welcome sequence + onboarding |
| Closed Lost | Add to "Win-back" sequence (30-day delay) |
## Rules
- ONLY send to contacts associated with the deal
- Check if contact has opted in to marketing before sending
- One campaign trigger per deal stage change (no duplicates)
- Log all campaign triggers for deal attribution

Ejemplo: Consulta en Lenguaje Natural

Tú: "Encuentra todos los tratos de HubSpot que cerraron este mes y asegúrate
de que esos contactos estén recibiendo nuestra secuencia de incorporación en Brevo."
Claude: Consultando HubSpot por tratos cerrados este mes...
[Usa HubSpot MCP para buscar tratos con closeddate en el mes actual]
Encontré 12 tratos cerrados este mes, involucrando 18 contactos.
Verificando Brevo para estos contactos...
[Usa brevo_contacts para buscar cada email]
Resultados:
- 14 contactos ya están en Brevo recibiendo la secuencia de incorporación
- 4 contactos aún no están en Brevo
Creando 4 nuevos contactos de Brevo y agregando a la lista de incorporación...
[Usa brevo_contacts para crear contactos]
[Usa brevo_lists para agregar a la lista "Onboarding"]
Listo. Los 18 contactos de los tratos cerrados este mes ya están
en la secuencia de incorporación de Brevo.

Próximos Pasos

Subscribe to updates

developer-docs

Drop your email or phone number — we'll send you what matters next.

auto-detect
Asistente AI

¡Hola! Pregúntame lo que quieras sobre la documentación.