MCP Evolution Whatsapp Api

🚀 MCP Evolution API Server

This is a Model Context Protocol (MCP) server designed for Claude, integrated with Evolution API, used for WhatsApp automation.

🚀 Quick Start

This MCP server enables Claude to interact with WhatsApp via the Evolution API, offering the following capabilities:

• Manage WhatsApp instances.
• Send various types of messages.
• Handle contacts and groups.
• Configure webhooks and settings.

✨ Features

📂 Project Structure

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

🚀 Quick Setup

Environment Configuration

Create a .env file containing your Evolution API credentials:

EVOLUTION_API_URL=https://your-evolution-api-server.com
EVOLUTION_API_KEY=your-api-key-here

📋 Deployment Options

Claude Desktop Configuration

To use this server in Claude Desktop, navigate to Settings > Extensions > Add Extension and paste the following:

{
  "title": "MCP Evolution API",
  "author": "Your Name",
  "version": "1.0",
  "description": "MCP extension for Evolution API",
  "main": "dist/main.js"
}

Implementation Status

📚 Documentation

Please refer to the Evolution API documentation for more technical details and usage guides.