Evolution API MCP

Name: Evolution API MCP
Author: pablobispo

pablobispo

Get started Repository

Connects Claude Desktop to WhatsApp through Evolution API for sending and managing messages.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add evolution-api-pablobispo --env EVOLUTION_API_TOKEN='<EVOLUTION_API_TOKEN>' --env EVOLUTION_BASE_URL='<EVOLUTION_BASE_URL>' --env EVOLUTION_INSTANCE_NAME='<EVOLUTION_INSTANCE_NAME>' -- uv --directory /caminho/completo/para/evoapi-mcp run evoapi-mcp

~/.codex/config.toml

[mcp_servers.evolution-api-pablobispo]
command = "uv"
args = ["--directory", "/caminho/completo/para/evoapi-mcp", "run", "evoapi-mcp"]
env = { EVOLUTION_API_TOKEN = "<EVOLUTION_API_TOKEN>", EVOLUTION_BASE_URL = "<EVOLUTION_BASE_URL>", EVOLUTION_INSTANCE_NAME = "<EVOLUTION_INSTANCE_NAME>" }

# codex mcp add evolution-api-pablobispo --env EVOLUTION_API_TOKEN='<EVOLUTION_API_TOKEN>' --env EVOLUTION_BASE_URL='<EVOLUTION_BASE_URL>' --env EVOLUTION_INSTANCE_NAME='<EVOLUTION_INSTANCE_NAME>' -- uv --directory /caminho/completo/para/evoapi-mcp run evoapi-mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "evolution-api-pablobispo": {
      "command": "uv",
      "args": [
        "--directory",
        "/caminho/completo/para/evoapi-mcp",
        "run",
        "evoapi-mcp"
      ],
      "env": {
        "EVOLUTION_API_TOKEN": "<EVOLUTION_API_TOKEN>",
        "EVOLUTION_BASE_URL": "<EVOLUTION_BASE_URL>",
        "EVOLUTION_INSTANCE_NAME": "<EVOLUTION_INSTANCE_NAME>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "evolution-api-pablobispo": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "/caminho/completo/para/evoapi-mcp",
        "run",
        "evoapi-mcp"
      ],
      "env": {
        "EVOLUTION_API_TOKEN": "<EVOLUTION_API_TOKEN>",
        "EVOLUTION_BASE_URL": "<EVOLUTION_BASE_URL>",
        "EVOLUTION_INSTANCE_NAME": "<EVOLUTION_INSTANCE_NAME>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "evolution-api-pablobispo": {
      "command": "uv",
      "args": [
        "--directory",
        "/caminho/completo/para/evoapi-mcp",
        "run",
        "evoapi-mcp"
      ],
      "env": {
        "EVOLUTION_API_TOKEN": "<EVOLUTION_API_TOKEN>",
        "EVOLUTION_BASE_URL": "<EVOLUTION_BASE_URL>",
        "EVOLUTION_INSTANCE_NAME": "<EVOLUTION_INSTANCE_NAME>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "evolution-api-pablobispo": {
      "command": "uv",
      "args": [
        "--directory",
        "/caminho/completo/para/evoapi-mcp",
        "run",
        "evoapi-mcp"
      ],
      "env": {
        "EVOLUTION_API_TOKEN": "<EVOLUTION_API_TOKEN>",
        "EVOLUTION_BASE_URL": "<EVOLUTION_BASE_URL>",
        "EVOLUTION_INSTANCE_NAME": "<EVOLUTION_INSTANCE_NAME>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "evolution-api-pablobispo": {
      "command": "uv",
      "args": [
        "--directory",
        "/caminho/completo/para/evoapi-mcp",
        "run",
        "evoapi-mcp"
      ],
      "env": {
        "EVOLUTION_API_TOKEN": "<EVOLUTION_API_TOKEN>",
        "EVOLUTION_BASE_URL": "<EVOLUTION_BASE_URL>",
        "EVOLUTION_INSTANCE_NAME": "<EVOLUTION_INSTANCE_NAME>"
      }
    }
  }
}

Environment variables

EVOLUTION_API_TOKEN
EVOLUTION_BASE_URL
EVOLUTION_INSTANCE_NAME

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related