WhatsApp MCP Server
MCP server que conecta agentes de AI a WhatsApp usando la librería evolution2-api-sdk.
Permite a un agente de AI enviar y recibir mensajes de WhatsApp de forma controlada, con permisos configurables y validación de whitelist.
Power your agent
पब्लिशर की अपनी कमांड। PlugMCP एंडपॉइंट नहीं।
Host a copy with our keys and logs.
npx -y @jskirk/[email protected]Claude Code में लोकल कमांड के लिए इंस्टॉल लिंक नहीं है। नीचे दी गई कमांड कॉपी करें और टर्मिनल में चलाएँ।
claude mcp add jskirk-mcp-whatsapp-evo -- npx -y @jskirk/mcp-whatsapp-evo@1.0.3टर्मिनल में चलाएँ।
{ "mcpServers": { "jskirk-mcp-whatsapp-evo": { "command": "npx", "args": [ "-y", "@jskirk/[email protected]" ] } }}claude_desktop_config.json
रिमोट URL या आपकी मशीन पर कमांड? दोनों इंस्टॉल में क्या अंतर है
PlugMCP पर चलाएँ
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
लॉन्चपब्लिशर से
MCP server que conecta agentes de AI a WhatsApp usando la librería evolution2-api-sdk.
Permite a un agente de AI enviar y recibir mensajes de WhatsApp de forma controlada, con permisos configurables y validación de whitelist.
MCP server for WhatsApp integration using evolution2-api-sdk. Connect AI agents to WhatsApp with permission controls and whitelist validation.
npm install -g @jskirk/mcp-whatsapp-evo
git clone https://github.com/jskfox/mcp-whatsapp-evo.git
cd mcp-whatsapp-evo
npm install
npm run build
La configuración se realiza mediante variables de entorno. Copia .env.example a .env y edita las credenciales:
cp .env.example .env
EVOLUTION_HOST=http://localhost:8080
EVOLUTION_API_KEY=mi-api-key
EVOLUTION_INSTANCE_NAME=mi-instancia
PERMISSIONS_TIER=admin
WHITELIST_ENABLED=true
WHITELIST_PHONES=+5491112345678,+5491187654321
[email protected]
WHITELIST_BLOCK_UNKNOWN=true
WEBHOOK_PORT=3000
WEBHOOK_PATH=/webhook
WEBHOOK_TOKEN=mi-token-secreto
# Carga variables de entorno desde .env
export $(cat .env | xargs)
npx @jskirk/mcp-whatsapp-evo
# O directamente con dotenv
node -r dotenv/config node_modules/.bin/mcp-whatsapp-evo
# Después de: npm install -g @jskirk/mcp-whatsapp-evo
mcp-whatsapp-evo
Si prefieres usar npx en lugar del binario global, configura tu editor así:
{
"mcpServers": {
"whatsapp": {
"command": "bash",
"args": ["-c", "source ~/.env_whatsapp && npx @jskirk/mcp-whatsapp-evo"]
}
}
}
{
"mcpServers": {
"whatsapp": {
"command": "bash",
"args": ["-c", "source ~/.env_whatsapp && npx @jskirk/mcp-whatsapp-evo"]
}
}
}
{
"mcpServers": {
"whatsapp": {
"command": "bash",
"args": ["-c", "source ~/.env_whatsapp && npx @jskirk/mcp-whatsapp-evo"]
}
}
}
{
"mcpServers": {
"whatsapp": {
"command": "bash",
"args": ["-c", "source ~/.env_whatsapp && npx @jskirk/mcp-whatsapp-evo"]
}
}
}
Crea ~/.env_whatsapp con las variables:
EVOLUTION_HOST=http://localhost:8080
EVOLUTION_API_KEY=mi-api-key
EVOLUTION_INSTANCE_NAME=mi-instancia
PERMISSIONS_TIER=admin
WHITELIST_ENABLED=true
WHITELIST_PHONES=+5491112345678
WEBHOOK_PORT=3000
WEBHOOK_TOKEN=mi-token
3 niveles jerárquicos:
admin > send > read
Un agente con tier send puede usar herramientas read y send, pero no admin.
Cuando WHITELIST_ENABLED=true:
WHITELIST_BLOCK_UNKNOWN=true, ignora mensajes de números no en whitelistCuando WHITELIST_ENABLED=false:
El servidor levanta un HTTP server en el puerto configurado (default: 3000).
El endpoint POST /webhook recibe mensajes entrantes de WhatsApp.
En tu Evolution API, configura la URL del webhook:
http://tu-servidor:3000/webhook?token=tu-token-secreto
{
"event": "messages.upsert",
"data": {
"key": {
"remoteJid": "[email protected]",
"fromMe": false
},
"message": {
"conversation": "Hola!"
},
"pushName": "Nombre"
}
}
n8n puede usar este MCP server como integración:
{
"mcpServers": {
"whatsapp": {
"command": "node",
"args": ["/path/to/mcp-whatsapp-evo/dist/index.js"]
}
}
}
Puedes usar n8n para recibir eventos del MCP y procesarlos:
Usa el n8n HTTP Request Node para llamar directamente a la Evolution API:
┌─────────────┐ HTTP Request ┌──────────────┐
│ n8n │ ──────────────────────► │ Evolution API│
│ Workflow │ │ (directo) │
└─────────────┘ └──────────────┘
Esta opción es útil si prefieres no usar MCP pero quieres automatizar con n8n.
Cuando un agente necesita ayuda humana:
Agente AI ──send_message──► WhatsApp ──webhook──► Humano
▲
│
Responde
│
Agente AI ◄──── Continúa ──────────────┘
El agente envía actualizaciones a usuarios:
Agente AI ──send_message──► WhatsApp ──► Usuario
El agente consulta información:
Agente AI ──get_messages──► WhatsApp ◄── Chat History
Los logs van a stdout/stderr:
[server] Starting WhatsApp MCP server...
[config] Loaded configuration from environment
[sdk] Evolution API SDK initialized
[sdk] Connected to WhatsApp instance
[mcp] Registered 16 tools
[mcp] MCP server started on stdio transport
[webhook] Webhook server running at http://localhost:3000
Verifica que tu Evolution API tenga la instancia conectada y el webhook configurado.
El número no está en la whitelist. Agrégalo a .env en WHITELIST_PHONES.
El tier del agente es insuficiente para esa tool. Aumenta el tier en PERMISSIONS_TIER.
npm test
# Instalar dependencias
npm install
# Build
npm run build
# Modo watch
npm run watch
# Lint
npm run lint
# Tests
npm test
# Login en npm
npm login
# Publicar (scoped package requiere access)
npm publish --access public
┌─────────────────────────────────────────────────────────┐
│ Agente AI │
└─────────────────┬───────────────────────────────────────┘
│ MCP (stdio)
┌─────────────────▼───────────────────────────────────────┐
│ MCP Server (mcp-whatsapp) │
│ ┌─────────────────────────────────────────────────┐ │
│ │ 1. Permission Guard (¿tiene tier suficiente?) │ │
│ └─────────────────────┬───────────────────────────┘ │
│ ┌─────────────────────▼───────────────────────────┐ │
│ │ 2. Whitelist Validator (¿está en lista blanca?) │ │
│ └─────────────────────┬───────────────────────────┘ │
│ ┌─────────────────────▼───────────────────────────┐ │
│ │ 3. Sanitizer (¿input seguro?) │ │
│ └─────────────────────┬───────────────────────────┘ │
│ ┌─────────────────────▼───────────────────────────┐ │
│ │ 4. Evolution SDK (¿respuesta válida?) │ │
│ └─────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘
│
┌─────────────────▼───────────────────────────────────────┐
│ Evolution API / WhatsApp │
└─────────────────────────────────────────────────────────┘
ISC
Jorge Solano Kirk
Hecho con ❤️
MCP server for WhatsApp integration using evolution2-api-sdk. Connect AI agents to WhatsApp with permission controls and whitelist validation.
{ "mcpServers": { "jskirk-mcp-whatsapp-evo": { "command": "npx", "args": [ "-y", "@jskirk/[email protected]" ] } }}टूल
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
@jskirk/mcp Whatsapp Evo stdio पर लोकल चलता है।
पिछली जाँच 2026-11-16 को हुई। MCP server for WhatsApp integration using evolution2-api-sdk. Connect AI agents to WhatsApp with permission controls and whitelist validation.