MCP Evolution Whatsapp Api MCP Server

An opinionated starter project for Model Context Protocol (MCP) servers

Local serverstdioTypeScript

What is the MCP Evolution Whatsapp Api MCP server?

Mcp evolution whatsapp api mcp server lets Claude, Cursor and other MCP clients work with MCP Evolution Whatsapp Api directly. An opinionated starter project for Model Context Protocol (MCP) servers.

What MCP Evolution Whatsapp Api does

A Model Context Protocol (MCP) server for Claude that integrates with Evolution API for WhatsApp automation.

This MCP server allows Claude to interact with WhatsApp through the Evolution API, enabling capabilities like: - Managing WhatsApp instances - Sending various types of messages - Working with contacts and groups - Configuring webhooks and settings

Installing the mcp evolution whatsapp api mcp server

The server is distributed via a container image as ghcr.io/aiteks-ltda/mcp-evo-api, so most clients can run it without a manual build step. Add it to your MCP client's configuration and restart the client to pick it up — the copy-paste configs for Claude Desktop, Claude Code and Cursor are on this page.

Configuration

Before the server will start you need to supply 3 environment variables: EVOLUTION_API_URL, EVOLUTION_API_KEY, REPLACE_WITH_YOUR_REAL_KEY. Keep credentials in your client's env block or a secrets manager rather than committing them.

Where it fits

Communication servers earn their keep on volume — summarising channels and threads that would otherwise cost you an hour of scrollback. MCP Evolution Whatsapp Api sits in that group. Worth comparing against the other communication servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

  • This server runs locally, so it operates with whatever access your machine and its credentials already have. Scope that deliberately rather than by default.
  • It will not start until its required credentials are present, so set those before wondering why the tools never appear.
  • Maintained by aiteks-ltda, written in TypeScript.
  • MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the mcp evolution whatsapp api mcp server actually does with your data.
  • Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

How to install the MCP Evolution Whatsapp Api MCP server

{
  "mcpServers": {
    "evo-api": {
      "command": "node",
      "args": [
        "/path/to/your/mcp-evo-api/dist/main.js"
      ]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
EVOLUTION_API_URLEndpoint or connection string the server talks to.Yes
EVOLUTION_API_KEYCredential the server authenticates with.Yes
REPLACE_WITH_YOUR_REAL_KEYCredential the server authenticates with.Yes

Frequently asked questions

It connects MCP Evolution Whatsapp Api to MCP-compatible AI assistants such as Claude and Cursor. Instead of copying data back and forth by hand, the assistant works with MCP Evolution Whatsapp Api directly.