Home / MCP / Evolution MCP API Server

Evolution MCP API Server

Provides MCP access to Evolution API for WhatsApp automation, enabling instance management, messaging, and webhook settings.

typescript

21stars

View on GitHub

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
    "mcpServers": {
        "evo-api": {
            "url": "http://localhost:3000"
        }
    }
}

You can connect Claude to WhatsApp through the Evolution API using this MCP server. It acts as a bridge between your Claude workflows and WhatsApp, enabling you to manage instances, send a variety of messages, handle contacts and groups, and configure webhooks and settings in a cohesive MCP environment.

How to use

Connect an MCP client to the Evolution API MCP server to start automation with WhatsApp. Use the HTTP endpoint to interact with the server from your MCP client or orchestration layer. You can run the server locally or deploy it via Docker Compose, then point your Claude MCP client at the provided URL. Once connected, you can manage WhatsApp instances, send messages (text, media, location, contacts, etc.), and configure webhooks and settings through MCP actions.

How to install

Prerequisites: you will need a runtime environment and tooling similar to the following options. Choose the path that fits your deployment needs.

# Local development setup (using Bun as shown in setup steps)
git clone https://github.com/aiteks-ltda/mcp-evo-api.git
cd mcp-evo-api
bun install
bun run dev

How to install

Alternative local production build and run path.

git clone https://github.com/aiteks-ltda/mcp-evo-api.git
cd mcp-evo-api
bun install
bun run build
bun run dist/main.js

How to install

Docker Compose deployment lets you run the MCP server as a service. Use this when you want a self-contained, orchestrated setup.

git clone https://github.com/aiteks-ltda/mcp-evo-api.git
cd mcp-evo-api
docker-compose up -d

How to install

If you prefer a standalone Docker container, run the container with the required environment variables.

docker run -d -p 3000:3000 -e EVOLUTION_API_URL=yoururl -e EVOLUTION_API_KEY=yourkey --name mcp-evo-api ghcr.io/aiteks-ltda/mcp-evo-api:latest

Configuration and runtime notes

The server expects Evolution API credentials to be provided via environment variables. Create a local .env with the following values, or configure them in your deployment environment.

EVOLUTION_API_URL=https://evo-api.decisao.ai/
EVOLUTION_API_KEY=REPLACE_WITH_YOUR_REAL_KEY

Claude Desktop configuration (HTTP MCP)

To connect Claude Desktop to the locally running MCP server, configure the HTTP MCP with the server URL.

{
  "mcpServers": {
    "evo-api": {
      "url": "http://localhost:3000",
      "args": []
    }
  }
}

Claude Desktop configuration (Docker deployment)

If you are deploying with Docker, point Claude Desktop at the container URL.

{
  "mcpServers": {
    "evo-api": {
      "url": "http://localhost:3000"
    }
  }
}