mcp-evolution-api
Provides tools for WhatsApp messaging, chat management, group operations, and instance management via the Evolution API. Allows sending text, media, location, polls, and more; managing chats and groups; checking connection status; and other WhatsApp operations.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-evolution-apisend a text message to +1234567890 saying 'Hello from MCP!'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-evolution-api
MCP server that wraps the Evolution API (WhatsApp) as semantic tools for LLM agents.
Works with Claude Code, Codex, Claude Desktop, Cursor, VS Code, Windsurf, and any MCP-compatible client.
Prerequisites
Node.js 18+
Evolution API instance running (docs)
Variable | Description |
| Base URL of your Evolution API instance |
| API key for authentication |
| Instance name (e.g. |
Related MCP server: mcp-zap
Installation
Claude Code
Three installation scopes are available:
Scope | Flag | Config file | Use case |
local |
|
| This project only (default) |
project |
|
| Shared with team via git |
user |
|
| All your projects |
claude mcp add evolution-api -s user \
-e EVOLUTION_BASE_URL=https://your-instance.example.com \
-e EVOLUTION_API_KEY=your-key \
-e EVOLUTION_INSTANCE=your-instance \
-- npx -y github:pauloFroes/mcp-evolution-apiReplace
-s userwith-s localor-s projectas needed.
Codex
Add to your Codex configuration:
[mcp_servers.evolution-api]
command = "npx"
args = ["-y", "github:pauloFroes/mcp-evolution-api"]
env_vars = ["EVOLUTION_BASE_URL", "EVOLUTION_API_KEY", "EVOLUTION_INSTANCE"]Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"evolution-api": {
"command": "npx",
"args": ["-y", "github:pauloFroes/mcp-evolution-api"],
"env": {
"EVOLUTION_BASE_URL": "https://your-instance.example.com",
"EVOLUTION_API_KEY": "your-key",
"EVOLUTION_INSTANCE": "your-instance"
}
}
}
}Cursor
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"evolution-api": {
"command": "npx",
"args": ["-y", "github:pauloFroes/mcp-evolution-api"],
"env": {
"EVOLUTION_BASE_URL": "https://your-instance.example.com",
"EVOLUTION_API_KEY": "your-key",
"EVOLUTION_INSTANCE": "your-instance"
}
}
}
}VS Code
Add to .vscode/mcp.json in your project:
{
"servers": {
"evolution-api": {
"command": "npx",
"args": ["-y", "github:pauloFroes/mcp-evolution-api"],
"env": {
"EVOLUTION_BASE_URL": "https://your-instance.example.com",
"EVOLUTION_API_KEY": "your-key",
"EVOLUTION_INSTANCE": "your-instance"
}
}
}
}Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"evolution-api": {
"command": "npx",
"args": ["-y", "github:pauloFroes/mcp-evolution-api"],
"env": {
"EVOLUTION_BASE_URL": "https://your-instance.example.com",
"EVOLUTION_API_KEY": "your-key",
"EVOLUTION_INSTANCE": "your-instance"
}
}
}
}Available Tools
Messaging (9)
Tool | Description |
| Block or unblock a contact |
| Send audio/voice note |
| Send contact card (vCard) |
| Send location pin |
| Send image, video, or document |
| Send a poll |
| React to a message with emoji |
| Send a sticker |
| Send a text message |
Chat (12)
Tool | Description |
| Archive or unarchive a chat |
| Verify if numbers exist on WhatsApp |
| Delete a message for everyone |
| Fetch contact profile information |
| Get contact profile picture URL |
| List all chats/conversations |
| Search WhatsApp contacts |
| Retrieve messages from a chat |
| Extract media as base64 from a message |
| Mark messages as read |
| Send typing/recording indicator |
| Edit a previously sent message |
Groups (10)
Tool | Description |
| Create a new group |
| Get group invite link |
| Get group info by JID |
| List group members |
| Leave a group |
| List all groups |
| Send group invite to numbers |
| Update group description |
| Update group profile picture |
| Update group name |
Instance (1)
Tool | Description |
| Check WhatsApp connection status |
Authentication
All requests use the apikey header. The instance name is automatically appended to API endpoint paths. Environment variables are validated at startup — the server fails fast if any are missing.
License
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/pauloFroes/mcp-evolution-api'
If you have feedback or need assistance with the MCP directory API, please join our Discord server