aiteks_ltda_mcp_evolution_whatsapp_api

aiteks_ltda_mcp_evolution_whatsapp_api

by aiteks-ltda
An MCP server enabling Claude to interact with WhatsApp via the Evolution API for automation tasks.

MCP Evolution WhatsApp API Server

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

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://your-evolution-api-server.com
EVOLUTION_API_KEY=your-api-key-here

Deployment Options

Environment Steps Command
Local Development 1. Clone and install
2. Run in dev mode		 git clone https://github.com/aiteks-ltda/mcp-evo-api.git && cd mcp-evo-api && bun install
bun run dev
Local Production 1. Clone and install
2. Build and run		 git clone https://github.com/aiteks-ltda/mcp-evo-api.git && cd mcp-evo-api && bun install
bun 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-api
docker-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.

About

MCP server for evolution, the non official api for whatsapp

Resources

Readme

License

MIT license

Activity

Stars

2 stars

Watchers

1 watching

Forks

1 fork

Report repository

Releases

No releases published

Packages 0

No packages published

Languages

Features & Capabilities

Categories
mcp_server model_context_protocol typescript javascript docker api_integration whatsapp claude automation

Implementation Details

View on GitHub

Stats

0 Views
2 GitHub Stars

Repository Info

aiteks-ltda Organization

Similar MCP Servers

continuedev_continue by continuedev
25049
cherryhq_cherry_studio by CherryHQ
21423
bytedance_ui_tars_desktop by bytedance
9300
2025© BestAI