MCP Evolution API
Note: The actual implementation currently only provides a basic greeting functionality (hello_tool), which appears to be a placeholder. The full Evolution API integration described below is not yet available.
This MCP server is intended to enable Claude to automate WhatsApp interactions through Evolution API integration. The planned capabilities include:
Instance Management: Create, connect, restart, logout, delete, and monitor WhatsApp instances
Messaging: Send text, media, audio, stickers, locations, contacts, reactions, polls, lists, and buttons
Contact & Chat Management: Find contacts and chats
Group Operations: Find groups by JID, fetch all groups, and find group members
Webhook & Settings: Configure webhooks and instance settings
Status Updates: Send status messages and set presence
The current implementation appears incomplete or represents an early development version.
Integration with Chatwoot is mentioned as a pending implementation in the documentation.
Integration with OpenAI is mentioned as a pending implementation under Bot Integrations.
Integration with RabbitMQ is mentioned as a pending implementation in the documentation.
Enables interaction with WhatsApp through Evolution API, supporting capabilities like managing instances, sending various message types (text, media, audio, stickers, locations, contacts, reactions, polls, lists, buttons), working with contacts and groups, and configuring webhooks.
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 message to +1234567890 saying 'Meeting at 3 PM tomorrow'"
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
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: WaPulse WhatsApp 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_KEYNote: 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 |
|
Local Production | 1. Clone and install2. Build and run |
|
Docker Compose | Run with Docker Compose |
|
Docker | Build and run container |
|
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). Vejaexamples/hono-bun/README.mdpara instruções de execução.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Tools
Latest Blog Posts
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/aiteks-ltda/mcp-evolution-whatsapp-api'
If you have feedback or need assistance with the MCP directory API, please join our Discord server