Skip to main content
Glama
Sign In
enesjakozh
MCP Evolution API

MCP Evolution API

by aiteks-ltda
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

MCP Evolution API

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

Overview

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

Related MCP server: Evolution API MCP Server

📂 Project Structure

mcp-evo-api/
├── src/
│   ├── tools/          # MCP tools implementation for Evolution API
│   ├── utils/          # Shared utilities, including Evolution API client
│   ├── main.ts         # Server entry point
│   └── types.ts        # Shared type definitions
├── scripts/            # Helper scripts
├── biome.json          # Linting configuration
├── tsconfig.json       # TypeScript configuration
├── docker-compose.yml  # Docker Compose configuration
├── Dockerfile          # Docker build configuration
└── package.json        # Project dependencies

🚀 Quick Setup

Environment Setup

Create a .env file with your Evolution API credentials:

EVOLUTION_API_URL=https://evo-api.decisao.ai/
EVOLUTION_API_KEY=REPLACE_WITH_YOUR_REAL_KEY

Note: you provided the API URL and a key. For security, never commit real API keys to the repository or share them publicly. Use a local .env file or a secrets manager in production.

📋 Deployment Options

Environment

Steps

Command

Local Development

1. Clone and install2. Run in dev mode

git clone https://github.com/aiteks-ltda/mcp-evo-api.git && cd mcp-evo-api && bun installbun run dev

Local Production

1. Clone and install2. Build and run

git clone https://github.com/aiteks-ltda/mcp-evo-api.git && cd mcp-evo-api && bun installbun run build && bun run dist/main.js

Docker Compose

Run with Docker Compose

git clone https://github.com/aiteks-ltda/mcp-evo-api.git && cd mcp-evo-apidocker-compose up -d

Docker

Build and run container

docker run -d -p 3000:3000 -e EVOLUTION_API_URL=yoururl -e EVOLUTION_API_KEY=yourkey --name mcp-evo-api ghcr.io/aiteks-ltda/mcp-evo-api:latest

Claude Desktop Configuration

Add this to your Claude Desktop config file (typically located at ~/Library/Application Support/Claude/claude_desktop_config.json):

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

If using the Docker deployment:

{
  "mcpServers": {
    "evo-api": {
      "url": "http://localhost:3000"
    }
  }
}

📊 Implementation Status

Category

Implemented

Pending Implementation

Core API

✅ Get Information✅ Create Instance✅ Fetch Instances✅ Instance Connect✅ Restart Instance✅ Connection State✅ Logout Instance✅ Delete Instance✅ Set Presence

❌ Check is WhatsApp

Webhook & Settings

✅ Set Webhook✅ Find Webhook✅ Set Settings✅ Find Settings

Messaging

✅ Send Plain Text✅ Send Status✅ Send Media✅ Send WhatsApp Audio✅ Send Sticker✅ Send Location✅ Send Contact✅ Send Reaction✅ Send Poll✅ Send List✅ Send Buttons

❌ Mark Message As Read❌ Mark Message As Unread❌ Archive Chat❌ Delete Message for Everyone❌ Update Message❌ Send Presence (Chat Ctrl)

Chat & Contacts

✅ Find Contacts✅ Find Chats

❌ Update Block Status❌ Fetch Profile Picture URL❌ Get Base64❌ Find Messages❌ Find Status Message

Groups

✅ Find Group by JID✅ Fetch All Groups✅ Find Group Members

❌ Create Group❌ Update Group Picture❌ Update Group Subject❌ Update Group Description❌ Fetch Invite Code❌ Revoke Invite Code❌ Send Group Invite❌ Find Group by Invite Code❌ Update Group Members❌ Update Group Setting❌ Toggle Ephemeral❌ Leave Group

Profile Settings

❌ Fetch Business Profile❌ Fetch Profile❌ Update Profile Name❌ Update Profile Status❌ Update Profile Picture❌ Remove Profile Picture❌ Fetch Privacy Settings❌ Update Privacy Settings

Bot Integrations

❌ Typebot Integrations❌ OpenAI Integrations❌ Evolution Bot❌ Dify Bot❌ Flowise Bot

Other Integrations

❌ Chatwoot❌ Websocket❌ SQS❌ RabbitMQ

For more information, refer to the Evolution API Documentation.

Examples

  • examples/hono-bun/ - pequeno servidor Hono para Bun (exemplo salvo). Veja examples/hono-bun/README.md para instruções de execução.

Available Tools

1 tool
hello_toolD

Hello tool

Inputs: name (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    C2.2/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of ambiguity or overlap between tools, as there are no other tools to compare it against. The single tool's purpose is inherently distinct by default.

    Naming Consistency5/5

    A single tool cannot demonstrate inconsistency, as there are no other tool names to compare it to. The naming pattern for 'hello_tool' (snake_case) is consistent within the set, albeit trivially so.

    Tool Count2/5

    A single tool is generally too few for most server purposes, as it limits functionality and suggests an incomplete or trivial implementation. While it might be appropriate for a minimal 'hello world' server, it is inadequate for any substantive domain coverage.

    Completeness1/5

    With only one tool named 'hello_tool', it is impossible to infer a meaningful domain or assess coverage. There are obvious gaps, as no CRUD operations, lifecycle management, or typical API interactions are present, making the surface severely incomplete for any practical purpose.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • WhatsApp MCP Server

      jlucaso1
      A
      license
      C
      quality
      D
      maintenance
      A Model Context Protocol server that connects your personal WhatsApp account to AI agents like Claude, enabling them to search messages, view contacts, retrieve chat history, and send messages via WhatsApp.
      7
      11 npm
      76
      ISC

    • WhatsApp MCP

      PONMANIAN-SA
      A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables interaction with WhatsApp through local stdio or remote HTTP/SSE connections. It allows users to send messages, manage groups, and access chat history using natural language.
      49 npm
      3
      MIT

    • mcp-zap

      Joaquim-Salles
      F
      license
      Not graded
      quality
      D
      maintenance
      MCP server for sending and receiving WhatsApp messages through Evolution API, enabling management of instances, messages, and chats directly from Claude Code.
      -

    Appeared in Searches