Evolution API

v0.2.0API Key

WhatsApp multi-device with QR code pairing. Messaging, groups, status updates, and contacts -- self-hosted friendly.

25 tools1 env vars🇧🇷 Brazilstable on npm

Install

terminal

$ npm install @codespar/mcp-evolution-api

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json

{
  "mcpServers": {
    "evolution-api": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-evolution-api"
      ],
      "env": {
        "EVOLUTION_API_KEY": "<your_evolution_api_key>"
      }
    }
  }
}

After restart, your agent can call any of the 25 tools below — try send_text first.

Environment variables · 1

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

EVOLUTION_API_KEY

requiredsecret

API key for evolution-api

Available tools · 25

Each tool is independent — your agent loads only what it needs to reduce context and response time.

WRITEsend_text

Send a text message via WhatsApp

WRITEsend_image

Send an image message via WhatsApp

WRITEsend_document

Send a document via WhatsApp

READget_instances

List all WhatsApp instances

WRITEcreate_instance

Create a new WhatsApp instance

READget_qrcode

Get QR code for instance pairing

READget_contacts

Get contacts from an instance

WRITEsend_poll

Send a poll message via WhatsApp

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Claude Agent SDKAnthropic

OpenAI AgentsOpenAI

Vercel AI SDKVercel

LangChainLangChain

LlamaIndexLlamaIndex

CrewAICrewAI

MastraMastra

Any MCP clientProtocol

Frequently asked questions

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets — it receives scoped, short-lived session tokens.