mcp-mailchimp

Servidor MCP de nivel de producción para la API de Marketing de Mailchimp. 71 herramientas que cubren campañas, audiencias, miembros, etiquetas, segmentos, plantillas, informes, automatizaciones, webhooks, campos de combinación, grupos de interés, páginas de destino, operaciones por lotes, comercio electrónico, pruebas A/B, notas de miembros, gestor de archivos y análisis de audiencia.

Creado para Claude Desktop, Claude Code, Cursor y cualquier cliente compatible con MCP.

Inicio rápido

1. Instalación

pip install mcp-mailchimp

O desde el código fuente:

git clone https://github.com/AlexlaGuardia/mcp-mailchimp.git
cd mcp-mailchimp
pip install .

2. Obtén tu clave API

Inicia sesión en Mailchimp
Ve a Account & Billing > Extras > API Keys
Haz clic en Create A Key
Copia la clave (formato: xxxxxxxxxx-usXX)

3. Configura tu cliente

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "mailchimp": {
      "command": "mcp-mailchimp",
      "env": {
        "MAILCHIMP_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code:

claude mcp add mailchimp -- env MAILCHIMP_API_KEY=your-key mcp-mailchimp

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "mailchimp": {
      "command": "mcp-mailchimp",
      "env": {
        "MAILCHIMP_API_KEY": "your-api-key-here"
      }
    }
  }
}

O ejecútalo directamente:

MAILCHIMP_API_KEY=your-key mcp-mailchimp

Herramientas (71)

Cuenta (1)

Herramienta	Descripción
`ping`	Valida la clave API y obtiene información de la cuenta

Campañas (11)

Herramienta	Descripción
`list_campaigns`	Lista campañas con filtros de estado/audiencia
`get_campaign`	Obtiene detalles de la campaña (configuración, seguimiento, destinatarios)
`create_campaign`	Crea una nueva campaña de correo electrónico
`update_campaign`	Actualiza la configuración de la campaña (asunto, nombre del remitente, etc.)
`send_campaign`	Envía una campaña inmediatamente
`schedule_campaign`	Programa una campaña para una hora específica
`unschedule_campaign`	Desprograma una campaña programada
`cancel_campaign`	Cancela una campaña que se está enviando actualmente
`delete_campaign`	Elimina permanentemente una campaña en borrador
`replicate_campaign`	Copia una campaña existente
`send_test_email`	Envía un correo electrónico de prueba a las direcciones especificadas

Contenido de la campaña (2)

Herramienta	Descripción
`get_campaign_content`	Obtiene el contenido HTML y de texto plano de la campaña
`set_campaign_content`	Establece el contenido mediante HTML o plantilla

Informes (5)

Herramienta	Descripción
`get_campaign_report`	Informe de rendimiento (aperturas, clics, rebotes, cancelaciones de suscripción)
`get_click_report`	Detalles de clics: qué URLs se hicieron clic y con qué frecuencia
`get_open_report`	Detalles de aperturas: qué suscriptores abrieron y cuándo
`get_unsubscribe_report`	Detalles de cancelaciones de suscripción: quién se fue y por qué
`get_sent_to_report`	Detalles de entrega: estado del destinatario (enviado, rebotado)

Audiencias (4)

Herramienta	Descripción
`list_audiences`	Lista todas las audiencias con recuentos de suscriptores
`get_audience`	Obtiene detalles y estadísticas de la audiencia
`create_audience`	Crea una nueva audiencia/lista
`update_audience`	Actualiza la configuración de la audiencia

Análisis de audiencia (3)

Herramienta	Descripción
`get_audience_growth`	Historial de crecimiento mensual: suscripciones, cancelaciones, cambio neto
`get_audience_locations`	Desglose de la ubicación de los suscriptores por país/región
`get_email_client_stats`	Rendimiento del dominio de correo electrónico: desglose de Gmail, Outlook, Apple Mail

Miembros (8)

Herramienta	Descripción
`list_members`	Lista/filtra miembros de la audiencia por estado
`get_member`	Obtiene detalles del suscriptor por correo electrónico
`add_or_update_member`	Añade un nuevo suscriptor o actualiza uno existente (upsert)
`archive_member`	Archiva (elimina de forma lógica) a un suscriptor
`delete_member_permanent`	Elimina permanentemente a un suscriptor (irreversible)
`batch_subscribe_members`	Suscribe por lotes hasta 500 miembros a la vez
`search_members`	Busca miembros en todas las audiencias
`get_member_activity`	Actividad reciente del suscriptor (aperturas, clics, etc.)

Notas de miembros (2)

Herramienta	Descripción
`list_member_notes`	Lista notas estilo CRM sobre un suscriptor
`add_member_note`	Añade una nota a un suscriptor

Etiquetas (2)

Herramienta	Descripción
`list_tags`	Lista todas las etiquetas de una audiencia
`manage_member_tags`	Añade o elimina etiquetas de un suscriptor

Segmentos (5)

Herramienta	Descripción
`list_segments`	Lista los segmentos guardados de una audiencia
`get_segment_members`	Lista los miembros de un segmento
`create_segment`	Crea un segmento estático a partir de direcciones de correo electrónico
`update_segment`	Actualiza el nombre del segmento o añade/elimina miembros
`delete_segment`	Elimina un segmento

Campos de combinación (2)

Herramienta	Descripción
`list_merge_fields`	Lista campos personalizados (FNAME, LNAME, personalizado)
`create_merge_field`	Crea un campo de combinación personalizado (texto, número, fecha, etc.)

Categorías de interés y grupos (2)

Herramienta	Descripción
`list_interest_categories`	Lista grupos de interés (casillas de verificación, menús desplegables, botones de opción)
`list_interests`	Lista opciones individuales dentro de una categoría

Plantillas (4)

Herramienta	Descripción
`list_templates`	Lista las plantillas de correo electrónico disponibles
`get_template`	Obtiene detalles de la plantilla y contenido HTML
`create_template`	Crea una nueva plantilla a partir de HTML
`delete_template`	Elimina una plantilla personalizada

Automatizaciones (5)

Herramienta	Descripción
`list_automations`	Lista automatizaciones clásicas
`get_automation`	Obtiene detalles de la automatización e información del disparador
`list_automation_emails`	Lista todos los correos electrónicos en un flujo de trabajo de automatización
`pause_automation`	Pausa todos los correos electrónicos en un flujo de trabajo
`start_automation`	Inicia todos los correos electrónicos en un flujo de trabajo

Webhooks (3)

Herramienta	Descripción
`list_webhooks`	Lista webhooks para una audiencia
`create_webhook`	Crea un webhook para eventos de audiencia
`delete_webhook`	Elimina un webhook

Comercio electrónico (6)

Herramienta	Descripción
`list_ecommerce_stores`	Lista tiendas conectadas (Shopify, WooCommerce, etc.)
`list_store_products`	Lista productos en una tienda conectada
`list_store_orders`	Lista pedidos: filtra por campaña para la atribución de ingresos
`get_ecommerce_customer`	Obtiene detalles del cliente con recuento de pedidos y total gastado
`list_store_carts`	Lista carritos abandonados para campañas de recuperación
`list_store_promo_codes`	Lista códigos promocionales para una regla de promoción

Pruebas A/B (1)

Herramienta	Descripción
`get_ab_test_results`	Obtiene resultados de campañas variadas: qué combinación ganó

Páginas de destino (2)

Herramienta	Descripción
`list_landing_pages`	Lista páginas de destino con estadísticas de visitas/conversiones
`get_landing_page`	Obtiene detalles de la página de destino y datos de seguimiento

Gestor de archivos (2)

Herramienta	Descripción
`list_files`	Lista archivos en el gestor de archivos de Mailchimp
`upload_file`	Sube un archivo (codificado en base64)

Operaciones por lotes (1)

Herramienta	Descripción
`create_batch_operation`	Envía hasta 500 operaciones de API en un solo lote

Ejemplos

"¿Qué campañas he enviado recientemente?"

Utiliza list_campaigns con status=sent para mostrar campañas recientes con estadísticas de apertura/clic.

"¿Cómo ha crecido mi audiencia este trimestre?"

Utiliza get_audience_growth para mostrar tendencias mensuales de suscripción/cancelación.

"¿Qué campaña generó más ingresos?"

Utiliza list_store_orders con campaign_id para ver la atribución de ingresos por campaña.

"Muéstrame los carritos abandonados de mi tienda Shopify"

Utiliza list_store_carts para encontrar oportunidades de recuperación.

"Añade una nota a john@example.com de que llamó sobre precios"

Utiliza add_member_note para la gestión de contactos estilo CRM.

"¿Qué línea de asunto de la prueba A/B ganó?"

Utiliza get_ab_test_results para ver qué variante tuvo mejor rendimiento.

"¿Dónde están ubicados mis suscriptores?"

Utiliza get_audience_locations para el desglose geográfico.

Requisitos

Python 3.10+
Cuenta de Mailchimp con clave API
Cliente compatible con MCP (Claude Desktop, Claude Code, Cursor, etc.)

Desarrollo

git clone https://github.com/AlexlaGuardia/mcp-mailchimp.git
cd mcp-mailchimp
pip install -e ".[dev]"
pytest

Licencia

MIT

Mailchimp MCP Server