MCP Evolution API

@aiteks-ltda

About MCP Evolution API

MCP server for evolution, the non official api for whatsapp

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.

Does MCP Evolution API require a specific runtime?

It requires Bun for development and can be run with Node after building. Docker is optional and provides a containerized deployment.

Frequently asked questions

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?

Does MCP Evolution API require a specific runtime?

It requires Bun for development and can be run with Node after building. Docker is optional and provides a containerized deployment.

Comments

Basic information

More Developer Tools MCP servers

Air Pipe

airpipe

Build, validate, deploy — HTTP APIs, cron jobs, webhooks and MCP tools — from your AI client.

BetterBugs

The BetterBugs MCP (Model Context Protocol) enables you to load BetterBugs bug reports (via report links) directly to your preferred AI Agents and developer environments with MCP Client capabilities (such as Cursor, VS C

Moxie Docs

Jackalope-Dev

Automated codebase documentation for GitHub: searchable docs, MCP context for AI agents, doc drift detection, and Friday Cleanup PRs.

TranscriptFetch MCP Server

TranscriptFetch

Model Context Protocol (MCP) server for TranscriptFetch: fetch YouTube transcripts, search, channels, and playlists from any MCP client.

PuzzleTide Puzzle Generator

Caravaca-Labs

Word search generator, crossword generator, and sudoku generator + solver as a local-first MCP server. 15 deterministic tools: printable PDF puzzle worksheets, themed word banks, and verifiable LLM evals. From the makers