MCP Evolution API

Name: MCP Evolution API
Author: aiteks-ltda

@aiteks-ltda

Repository

About MCP Evolution API

MCP server for evolution, the non official api for whatsapp

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "evo-api": {
      "command": "node",
      "args": [
        "/path/to/your/mcp-evo-api/dist/main.js"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Evolution API?

MCP Evolution API is a Model Context Protocol (MCP) server that integrates Claude with Evolution API for WhatsApp automation. It enables managing WhatsApp instances, sending various message types, working with contacts and groups, and configuring webhooks and settings.

How to use MCP Evolution API?

Set up a .env file with EVOLUTION_API_URL and EVOLUTION_API_KEY. Deploy locally with Bun (bun install, bun run dev), build for production (bun run build, bun run dist/main.js), or use Docker/Docker Compose. Add the server to Claude Desktop’s configuration file (claude_desktop_config.json) with the path to the built JavaScript file or the Docker container URL.

Key features of MCP Evolution API

Manage WhatsApp instances (create, connect, restart, delete)
Send plain text, media, audio, stickers, location, contacts
Send reactions, polls, lists, and buttons
Manage webhooks and instance settings
Find contacts, chats, and groups
View connection state and set presence

Use cases of MCP Evolution API

Automate WhatsApp messaging through Claude
Send bulk or templated messages to contacts and groups
Monitor and manage WhatsApp instance status
Integrate WhatsApp notifications into AI workflows

FAQ from MCP Evolution API

What credentials are required to use MCP Evolution API?

You need an Evolution API instance URL (EVOLUTION_API_URL) and an API key (EVOLUTION_API_KEY), stored in a .env file.

How can I deploy MCP Evolution API with Docker?

Clone the repository and run docker-compose up -d for Compose, or use docker run with environment variables and expose port 3000.

How do I configure MCP Evolution API with Claude Desktop?

Add an entry to claude_desktop_config.json specifying the command and args for local Node execution, or the url pointing to a running Docker container.

Which Evolution API features are currently implemented?

The server implements core API (instance management), webhook/settings, messaging (text, media, reactions, polls, lists, buttons), chat/contacts, and group lookup. Group creation, profile settings, bot integrations, and some other features are pending.