JosemaAD/mailchimp-mcp-server
If you are the rightful owner of mailchimp-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.
A simple MCP server that allows Claude to access and manage your Mailchimp account naturally.
🚀 Servidor MCP Mailchimp para Claude
Un servidor MCP simple que permite a Claude acceder a tu cuenta de Mailchimp y gestionar audiencias, campañas y métricas de forma natural.
⚡ Instalación Rápida
Paso 1: Clonar e Instalar
git clone https://github.com/JosemaAD/mailchimp-mcp-server.git
cd mailchimp-mcp-server
./install.sh
Paso 2: Configurar Credenciales
Edita el archivo .env con tus datos de Mailchimp:
MAILCHIMP_API_KEY=tu_api_key_aqui
MAILCHIMP_SERVER_PREFIX=tu_datacenter
Paso 3: Iniciar Servidor
./start-mcp.sh
Paso 4: Configurar en Claude
Opción A: Claude Desktop (Recomendado)
- Abre Claude Desktop
- Ve a Settings > Tools
- Haz clic en Add Tool
- Selecciona MCP Server
- Configura:
- Name: Mailchimp
- Command:
node - Arguments:
src/mcp-server.js - Working Directory: (ruta del proyecto)
Opción B: Claude Web (Anthropic Console)
- Ve a console.anthropic.com
- En tu conversación, escribe:
/tools - Selecciona Add MCP Server
- Configura los mismos parámetros que arriba
Opción C: Claude API Si usas Claude a través de API, agrega el servidor MCP a tu configuración de cliente.
🛠️ Herramientas Disponibles
| Herramienta | Descripción | Ejemplo de Uso |
|---|---|---|
list-audiences | Lista todas las audiencias | "Lista mis audiencias de Mailchimp" |
get-campaigns | Campañas más recientes | "Muéstrame las últimas campañas" |
get-campaign-metrics | Métricas de rendimiento | "¿Qué campañas tienen mejor apertura?" |
get-account-info | Información de la cuenta | "Dime información de mi cuenta" |
get-audience-growth | Crecimiento de audiencias | "¿Cuál es mi audiencia más grande?" |
add-subscriber | Agregar suscriptor | "Agrega un suscriptor a la lista X" |
💬 Ejemplos de Preguntas para Claude
📊 Audiencias
- "Lista mis audiencias de Mailchimp"
- "¿Cuántos miembros tiene mi audiencia principal?"
- "Muéstrame el crecimiento de mis audiencias"
📧 Campañas
- "¿Qué campañas tienen mejor apertura?"
- "Muéstrame las métricas de clicks de mis campañas"
- "¿Cuáles son mis campañas más recientes?"
📈 Métricas
- "¿Qué campañas tienen mejor rendimiento?"
- "Muéstrame las estadísticas de mi cuenta"
- "¿Cuál es mi tasa de apertura promedio?"
🔧 Solución de Problemas
❌ Error de Conexión
- Verifica que tus credenciales en
.envsean correctas - Asegúrate de que tu API key tenga permisos de lectura
❌ Servidor No Inicia
- Verifica que Node.js esté instalado:
node --version - Instala dependencias:
npm install
❌ Claude No Encuentra el Servidor
- Verifica que el servidor esté ejecutándose
- Comprueba la configuración en Claude
- Revisa los logs del servidor
❌ Problemas con MCP en Claude
- Asegúrate de usar Claude Desktop o la versión web más reciente
- Verifica que el servidor MCP esté ejecutándose antes de configurar en Claude
- Consulta la documentación oficial de MCP
📋 Requisitos
- Node.js 16 o superior
- Cuenta de Mailchimp con API key
- Claude Desktop o Claude Web con soporte MCP
🔒 Seguridad
- Las credenciales se almacenan localmente en
.env - No se envían datos a servidores externos
- Solo acceso de lectura a datos de Mailchimp
📞 Soporte
Si tienes problemas:
- Verifica que Node.js esté instalado
- Comprueba tus credenciales de Mailchimp
- Revisa los logs del servidor
- Consulta la documentación completa en
USO.md - Verifica la documentación oficial de MCP
🤝 Contribuir
- Fork el proyecto
- Crea una rama para tu feature (
git checkout -b feature/AmazingFeature) - Commit tus cambios (
git commit -m 'Add some AmazingFeature') - Push a la rama (
git push origin feature/AmazingFeature) - Abre un Pull Request
📄 Licencia
Este proyecto está bajo la Licencia MIT - ver el archivo para detalles.
¡Listo! Ahora puedes usar Claude para gestionar tu cuenta de Mailchimp de forma natural. 🎉