evolution-api-mcp

Name: evolution-api-mcp
Author: singleflo

singleflo

MCP server for one Evolution API (WhatsApp) instance: chats, history, sending, groups and configuration. Local (uvx) and hosted.

Setup

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

Add to Cursor Add to VS Code

Local

claude mcp add evolution-api --env EVOLUTION_API_URL='<EVOLUTION_API_URL>' --env EVOLUTION_INSTANCE_TOKEN='<EVOLUTION_INSTANCE_TOKEN>' -- uvx evolution-api-mcp

~/.codex/config.toml

[mcp_servers.evolution-api]
command = "uvx"
args = ["evolution-api-mcp"]
env = { EVOLUTION_API_URL = "<EVOLUTION_API_URL>", EVOLUTION_INSTANCE_TOKEN = "<EVOLUTION_INSTANCE_TOKEN>" }

# codex mcp add evolution-api --env EVOLUTION_API_URL='<EVOLUTION_API_URL>' --env EVOLUTION_INSTANCE_TOKEN='<EVOLUTION_INSTANCE_TOKEN>' -- uvx evolution-api-mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "evolution-api": {
      "command": "uvx",
      "args": [
        "evolution-api-mcp"
      ],
      "env": {
        "EVOLUTION_API_URL": "<EVOLUTION_API_URL>",
        "EVOLUTION_INSTANCE_TOKEN": "<EVOLUTION_INSTANCE_TOKEN>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "evolution-api": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "evolution-api-mcp"
      ],
      "env": {
        "EVOLUTION_API_URL": "<EVOLUTION_API_URL>",
        "EVOLUTION_INSTANCE_TOKEN": "<EVOLUTION_INSTANCE_TOKEN>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "evolution-api": {
      "command": "uvx",
      "args": [
        "evolution-api-mcp"
      ],
      "env": {
        "EVOLUTION_API_URL": "<EVOLUTION_API_URL>",
        "EVOLUTION_INSTANCE_TOKEN": "<EVOLUTION_INSTANCE_TOKEN>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "evolution-api": {
      "command": "uvx",
      "args": [
        "evolution-api-mcp"
      ],
      "env": {
        "EVOLUTION_API_URL": "<EVOLUTION_API_URL>",
        "EVOLUTION_INSTANCE_TOKEN": "<EVOLUTION_INSTANCE_TOKEN>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "evolution-api": {
      "command": "uvx",
      "args": [
        "evolution-api-mcp"
      ],
      "env": {
        "EVOLUTION_API_URL": "<EVOLUTION_API_URL>",
        "EVOLUTION_INSTANCE_TOKEN": "<EVOLUTION_INSTANCE_TOKEN>"
      }
    }
  }
}

Remote

claude mcp add --transport http evolution-api https://evolution-mcp.singleflo.com/mcp

~/.codex/config.toml

[mcp_servers.evolution-api]
url = "https://evolution-mcp.singleflo.com/mcp"

# codex mcp add evolution-api --url https://evolution-mcp.singleflo.com/mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "evolution-api": {
      "url": "https://evolution-mcp.singleflo.com/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "evolution-api": {
      "type": "http",
      "url": "https://evolution-mcp.singleflo.com/mcp"
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "evolution-api": {
      "httpUrl": "https://evolution-mcp.singleflo.com/mcp"
    }
  }
}

claude_desktop_config.json · Customize › Connectors › Add custom connector

{
  "mcpServers": {
    "evolution-api": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://evolution-mcp.singleflo.com/mcp"
      ]
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "evolution-api": {
      "url": "https://evolution-mcp.singleflo.com/mcp"
    }
  }
}

Environment variables

EVOLUTION_API_URL
EVOLUTION_INSTANCE_TOKEN

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

Setup

Local

Remote

Environment variables

Related