Evolution WhatsApp

Local install

io.github.Ewertonslv/evolution-whatsapp-mcpv0.3.1 GitHub verified

Send and read WhatsApp messages, send media and manage instances via the Evolution API.

Communication

Watch Source Website

Registry entry

Open in the registry

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-11-09T15:45:06.217304Z",
      "publishedAt": "2026-11-09T15:45:06.217304Z",
      "statusChangedAt": "2026-11-09T15:45:06.217304Z"
    }
  },
  "server": {
    "name": "io.github.Ewertonslv/evolution-whatsapp-mcp",
    "title": "Evolution WhatsApp",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "version": "0.3.1",
    "packages": [
      {
        "version": "0.3.1",
        "transport": {
          "type": "stdio"
        },
        "identifier": "evolution-whatsapp-mcp",
        "registryType": "npm",
        "registryBaseUrl": "https://registry.npmjs.org",
        "environmentVariables": [
          {
            "name": "EVOLUTION_API_URL",
            "isRequired": true,
            "description": "Base URL of your Evolution API server, e.g. http://localhost:8080. Use https outside localhost."
          },
          {
            "name": "EVOLUTION_API_KEY",
            "isSecret": true,
            "isRequired": true,
            "description": "Evolution API key, sent as the apikey header."
          },
          {
            "name": "EVOLUTION_DEFAULT_INSTANCE",
            "description": "Default instance used when a tool call omits the instance argument."
          },
          {
            "name": "EVOLUTION_TIMEOUT_MS",
            "description": "Per-request timeout in milliseconds (default 30000)."
          },
          {
            "name": "EVOLUTION_READ_ONLY",
            "description": "Set to true to hide every tool that sends or changes state (send_text, send_media, create_instance, disconnect_instance, configure_webhook)."
          },
          {
            "name": "EVOLUTION_CONFIRM_WRITES",
            "default": "false",
            "description": "Set to true to require a human confirmation (elicitation dialog) before send_text, send_media, create_instance, disconnect_instance or configure_webhook run. Clients that can show no dialog are refused. Default false; an unrecognised value counts as true and prints a warning."
          },
          {
            "name": "EVOLUTION_ALLOWED_NUMBERS",
            "description": "Comma-separated phone numbers that send_text and send_media may reach. Empty means no restriction."
          }
        ]
      }
    ],
    "repository": {
      "url": "https://github.com/Ewertonslv/evolution-whatsapp-mcp",
      "source": "github"
    },
    "websiteUrl": "https://github.com/Ewertonslv/evolution-whatsapp-mcp#readme",
    "description": "Send and read WhatsApp messages, send media and manage instances via the Evolution API."
  }
}

Maintain this server? Claim it

Try it

This server only runs locally, from a package. Install it with the instructions on this page to try it.

Install

Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.

One click: Add to Cursor Add to VS Code Add to LM StudioThen replace the YOUR_ values and {placeholders} with your own.

Run in a terminal

claude mcp add evolution-whatsapp-mcp \
  -e EVOLUTION_API_URL=YOUR_EVOLUTION_API_URL \
  -e EVOLUTION_API_KEY=YOUR_EVOLUTION_API_KEY \
  -- npx -y [email protected]

Environment

EVOLUTION_API_URL (required): Base URL of your Evolution API server, e.g. http://localhost:8080. Use https outside localhost.
EVOLUTION_API_KEY (required): Evolution API key, sent as the apikey header.
EVOLUTION_DEFAULT_INSTANCE (optional, not in the config above): Default instance used when a tool call omits the instance argument.
EVOLUTION_TIMEOUT_MS (optional, not in the config above): Per-request timeout in milliseconds (default 30000).
EVOLUTION_READ_ONLY (optional, not in the config above): Set to true to hide every tool that sends or changes state (send_text, send_media, create_instance, disconnect_instance, configure_webhook).
EVOLUTION_CONFIRM_WRITES (optional, not in the config above): Set to true to require a human confirmation (elicitation dialog) before send_text, send_media, create_instance, disconnect_instance or configure_webhook run. Clients that can show no dialog are refused. Default false; an unrecognised value counts as true and prints a warning.
EVOLUTION_ALLOWED_NUMBERS (optional, not in the config above): Comma-separated phone numbers that send_text and send_media may reach. Empty means no restriction.

Tools

We don't run packages, so we can't list this server's tools.