MCP Evolution API

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.