MCP.so
Sign In

MCP Evolution API

@aiteks-ltda

Basic information

Category

Developer Tools

License

MIT

Transports

stdio

Author

aiteks-ltda

About MCP Evolution API

MCP server for evolution, the non official api for whatsapp

MCP Evolution API 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"
      ]
    }
  }
}

MCP Evolution API tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

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.

2

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.

3

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.

4

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.

5

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

More Developer Tools MCP servers