Evolution API MCP Server

Evolution API uses an API key passed via the apikey header. Evolution API is self-hosted. Deploy your own instance using Docker for testing. Its 25 documented tools cover group, instance, chat, message.

People connecting communication tools to Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

One of 127 MCP servers published from codespar/mcp-dev-latam. Stars and repository activity are shared across all of them. See all 127 →

VERIFIED ACTIVE

LAST COMMIT 2026-08-12 · VERIFIED 2026-08-25

MIT · JavaScript servers · how we verify → /methodology

01 · Install Evolution API

before you install - you'll need

Set EVOLUTION_API_URL, EVOLUTION_API_KEY before connecting.

Claude Code

claude mcp add codespar-mcp-dev-latam-packages-communic -- npx -y @codespar/mcp-evolution-api

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "codespar-mcp-dev-latam-packages-communic": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-evolution-api"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @codespar/mcp-evolution-api - published under the repo owner's npm scope (@codespar)

registry namespace io.github.codespar is GitHub-verified and matches the repo owner

03 · What Evolution API can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can send a text message via WhatsApp, send an image message via WhatsApp, send a document via WhatsApp, and list all WhatsApp instances.

Capability map

Tools grouped from the project's README - what Evolution API lets an agent do.

read & search

5 tools - e.g. List all WhatsApp instances; Get QR code for instance pairing; Get contacts from an instance

get_instances · get_qrcode · get_contacts · get_messages · get_chat_history

Group

5 tools - e.g. Create a WhatsApp group; Get group metadata, participants, and settings; Leave a WhatsApp group

create_group · get_group_info · leave_group · update_group_participants · fetch_group_invite_code

run & execute

4 tools - e.g. Send a text message via WhatsApp; Send an image message via WhatsApp; Send a document via WhatsApp

send_text · send_image · send_document · send_poll

Instance

4 tools - e.g. Create a new WhatsApp instance; Logout an instance (disconnects the WhatsApp session without deleting the instance); Restart an instance

create_instance · logout_instance · restart_instance · delete_instance

update

2 tools - e.g. Update instance profile (name, status text, or picture); Set online/offline presence for an instance

update_profile · set_presence

Check

1 tool - e.g. Check if a phone number is registered on WhatsApp

check_number

Connection

1 tool - e.g. Get the connection state of an instance (open, connecting, close)

connection_state

Mark

1 tool - e.g. Mark one or more messages in a chat as read

mark_message_as_read

04 · Who maintains Evolution API

mcp-evolution-api is maintained by codespar. We track 127 MCP servers from codespar - 127 actively maintained, 269 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from codespar.

05 · Facts

repository: github.com/codespar/mcp-dev-latam
category: communication - actively maintained as of 2026-08-25.
registry: io.github.codespar/mcp-evolution-api (active, first published 2026-04-12 · 3 versions)
packages: npm:@codespar/mcp-evolution-api

06 · Evolution API FAQ

Is Evolution API still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-12. We re-verify nightly.

What can Evolution API do?

With this server connected, an agent can send a text message via WhatsApp, send an image message via WhatsApp, send a document via WhatsApp, and list all WhatsApp instances.

How do I install Evolution API?

Run `npx -y @codespar/mcp-evolution-api`. The README documents 2 environment variables (EVOLUTION_API_URL, EVOLUTION_API_KEY) to set first. Set EVOLUTION_API_URL, EVOLUTION_API_KEY before connecting. You can also paste the ready-made client config above.

Does Evolution API run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Evolution API

Alternatives to Evolution API

Maintained communication servers if Evolution API isn't the fit.

Pairs well with

Servers that cover what Evolution API doesn't - only shown when the pairing reason fits the companion.

More communication MCP servers · Take Blip · Twilio · Whatsapp Cloud · Z API · Zenvia

More JavaScript MCP servers · Rd Station · SendGrid · see all