Evolution WhatsApp API

by aiteks-ltda

9 stars

295 downloads

Not rated

GitHub

About

Connects AI systems to WhatsApp through the Evolution API, enabling message management, media sharing, and contact operations for automated customer service and messaging workflows.

Details

Author: aiteks-ltda
Repository: aiteks-ltda/mcp-evolution-whatsapp-api
GitHub stars: 9
Downloads: 295
License: MIT License
Categories: Communication, Other, API, Productivity, Developer Tools, Design, AI, Community, Media, Frontend
Tags: #integration

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Evolution WhatsApp API

Command (node, npx, python, etc.) node
Arguments
- Argument 1 /path/to/your/mcp-evo-api/dist/main.js
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

{
    "mcpServers": {
        "evolution whatsapp api": {
            "env": {},
            "args": [
                "/c",
                "node",
                "/path/to/your/mcp-evo-api/dist/main.js"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

{
    "mcpServers": {
        "evolution whatsapp api": {
            "env": {},
            "args": [
                "/c",
                "node",
                "/path/to/your/mcp-evo-api/dist/main.js"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

{
    "mcpServers": {
        "evolution whatsapp api": {
            "env": {},
            "args": [
                "/c",
                "node",
                "/path/to/your/mcp-evo-api/dist/main.js"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

{
    "mcpServers": {
        "evolution whatsapp api": {
            "env": {},
            "args": [
                "/c",
                "node",
                "/path/to/your/mcp-evo-api/dist/main.js"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

{
    "mcpServers": {
        "evolution whatsapp api": {
            "env": {},
            "args": [
                "/c",
                "node",
                "/path/to/your/mcp-evo-api/dist/main.js"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

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

From the repository

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

`Get Information`

Retrieve information from the MCP server.

`Create Instance`

Create a new WhatsApp instance.

`Fetch Instances`

Fetch a list of all WhatsApp instances managed by the server.

`Instance Connect`

Connect to a specified WhatsApp instance.

`Restart Instance`

Restart a specified WhatsApp instance.

`Connection State`

Get the connection state of a specified WhatsApp instance.

`Logout Instance`

Log out of a specified WhatsApp instance.

`Delete Instance`

Delete a specified WhatsApp instance.

`Set Presence`

Set the presence status of the WhatsApp instance.

`Set Webhook`

Configure a webhook for the WhatsApp instance.

`Find Webhook`

Retrieve details of the configured webhook.

`Set Settings`

Configure settings for the WhatsApp instance.

`Find Settings`

Retrieve current settings of the WhatsApp instance.

`Send Plain Text`

Send a plain text message to a WhatsApp contact.

`Send Status`

Send a status update to a WhatsApp contact.

`Send Media`

Send media files (images, videos, etc.) to a WhatsApp contact.

`Send WhatsApp Audio`

Send an audio message to a WhatsApp contact.

`Send Sticker`

Send a sticker to a WhatsApp contact.

`Send Location`

Send a location to a WhatsApp contact.

`Send Contact`

Send a contact card to a WhatsApp contact.

`Send Reaction`

Send a reaction to a message in a WhatsApp chat.

`Send Poll`

Send a poll to a WhatsApp chat.

`Send List`

Send a list of options to a WhatsApp contact.

`Send Buttons`

Send a message with buttons to a WhatsApp contact.

`Find Contacts`

Retrieve a list of contacts from WhatsApp.

`Find Chats`

Retrieve a list of chats from WhatsApp.

`Find Group by JID`

Find a WhatsApp group using its JID.

`Fetch All Groups`

Fetch a list of all WhatsApp groups.

`Find Group Members`

Retrieve a list of members in a specified WhatsApp group.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

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

Macos

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

Windows

{
    "env": [],
    "args": [
        "/c",
        "node",
        "/path/to/your/mcp-evo-api/dist/main.js"
    ],
    "shell": false,
    "command": "cmd"
}

A Model Context Protocol (MCP) server for Claude that integrates withEvolution APIfor 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

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

Create a.envfile 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.envfile or a secrets manager in production.

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" ] } } }

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

For more information, refer to theEvolution API Documentation.

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

Connect WasenderAPI to AI agents and automation tools using the Model Context Protocol. This remote MCP server exposes WhatsApp session management, messaging, contacts, and groups as callable tools for MCP-compatible platforms

A multi-device WhatsApp API server for AI agents and tools.

Send and receive messages using the WhatsApp API.

Interact with the YCloud WhatsApp API to send and manage messages.

Manage your WhatsApp, SMS and Phone Calls using a single MCP connector

Enables seamless integration with communication platform that allows you to reach your customers globally across any channel.

Interact with any other SaaS applications on behalf of your customers.

Official MCP Server to interact with Pearl API. Connect your AI Agents with 12,000+ certified experts instantly.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Get Information

Create Instance

Fetch Instances

Instance Connect

Restart Instance

Connection State

Logout Instance

Delete Instance

Set Presence

Set Webhook

Find Webhook

Set Settings

Find Settings

Send Plain Text

Send Status

Send Media

Send WhatsApp Audio

Send Sticker

Send Location

Send Contact

Send Reaction

Send Poll

Send List

Send Buttons

Find Contacts

Find Chats

Find Group by JID

Fetch All Groups

Find Group Members

Claude Desktop / Cursor

Linux

Macos

Windows

Install

More like this

Sequential Thinking

Slack

Filesystem

EverArt

Google Drive

GitLab

`Get Information`

`Create Instance`

`Fetch Instances`

`Instance Connect`

`Restart Instance`

`Connection State`

`Logout Instance`

`Delete Instance`

`Set Presence`

`Set Webhook`

`Find Webhook`

`Set Settings`

`Find Settings`

`Send Plain Text`

`Send Status`

`Send Media`

`Send WhatsApp Audio`

`Send Sticker`

`Send Location`

`Send Contact`

`Send Reaction`

`Send Poll`

`Send List`

`Send Buttons`

`Find Contacts`

`Find Chats`

`Find Group by JID`

`Fetch All Groups`

`Find Group Members`