Evolution Api

stdio

Operate one Evolution API (WhatsApp) instance: chats, history, sending, groups, settings.

Getting Started

npx @getmcp/cli add io.github.singleflo/evolution-api-mcp

Requires Python 3.10+. Community-contributed server. Review source before installing.

Claude Desktopguide →Vscodeguide →Cursorguide →Windsurfguide →

Required Environment Variables

EVOLUTION_API_URL
URL of your Evolution API server (e.g. https://evolution.example.com). Evolution API 2.x is required.
EVOLUTION_INSTANCE_TOKEN
The token of this one instance (Evolution Manager: open the instance and copy its token). The server's global AUTHENTICATION_API_KEY is refused. The instance name and integration are discovered from the token.

Configuration

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json

JSON

{
  "mcpServers": {
    "io.github.singleflo/evolution-api-mcp": {
      "command": "uvx",
      "args": [
        "evolution-api-mcp"
      ],
      "env": {
        "EVOLUTION_API_URL": "",
        "EVOLUTION_INSTANCE_TOKEN": "",
        "EVOLUTION_MCP_TOOLSETS": "",
        "EVOLUTION_MCP_ALLOW": "",
        "EVOLUTION_MCP_DENY": "",
        "EVOLUTION_MCP_ALLOW_IRREVERSIBLE": "",
        "EVOLUTION_MCP_DEFAULT_DELAY_MS": "",
        "EVOLUTION_MCP_MAX_WRITES_PER_MINUTE": "",
        "EVOLUTION_MCP_FILE_ROOTS": "",
        "EVOLUTION_MCP_DOWNLOAD_DIR": "",
        "EVOLUTION_MCP_TIMEZONE": ""
      }
    }
  }
}

Claude Desktop MCP documentation