mcp-evolution-api

mcp-evolution-api

1

The MCP Evolution API server facilitates integration with WhatsApp using the Evolution API, providing tools for instance management, message sending, and QR code generation. It's designed for efficient interaction with WhatsApp instances via a secure API Key authentication method.

Overview

This MCP (Model Context Protocol) server allows language models to interact with WhatsApp via the Evolution API, enabling features such as:

  • WhatsApp instance management
  • Sending text messages
  • Obtaining QR codes for connection
  • Checking the status of instances

Quick Setup

  • Requirements: Node.js 18 or higher, NPM or Yarn, access to an Evolution API installation (URL and API Key)

Available Tools

  • createEvolutionInstance: Creates a new WhatsApp instance
  • listEvolutionInstances: Lists all available instances
  • getWhatsAppQrCode: Obtains the QR code for connecting an instance
  • sendWhatsAppMessage: Sends a text message to a contact

Deployment Options

  • Local Development: Clone, install, and run in dev mode
  • Local Production: Clone, install, build, and run
  • Docker: Run Docker container with appropriate environment variables