πŸš€ WhatsApp Flows API MCP Server

by Ronnie-Leon76

322 downloads Not rated yet
GitHub

About

WhatsApp Flows MCP Server for business to automate survey creation and data collection through WhatsApp platform

Explore

- 🐳 Dockerized Architecture - Complete containerized setup with Redis and background processing
- πŸ”§ Modular ERP Integration - Support for Business Central, SAP, Oracle, and custom ERP systems
- ⚑ Background Processing - Async job processing for handling large customer lists
- πŸ“± WhatsApp Flow Management - Create and send interactive surveys via WhatsApp Business API
- πŸ“Š Monitoring Tools - Built-in dashboards for job monitoring and Redis management
- πŸ”„ Development Support - Hot reload and development containers for rapid iteration

---

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:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name πŸš€ WhatsApp Flows API MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Before you begin, ensure you have:
- βœ… Docker and Docker Compose installed
- βœ… WhatsApp Business API credentials
- βœ… Environment variables configured

git clone https://github.com/Ronnie-Leon76/whatsapp-flows-mcp-server.git
cd whatsapp-flows-mcp-server

cp .env.example .env

env

WHATSAPP_ACCESS_TOKEN=your_access_token_here
WHATSAPP_PHONE_NUMBER_ID=your_phone_number_id_here
WHATSAPP_BUSINESS_ACCOUNT_ID=your_business_account_id_here
WHATSAPP_VERIFY_TOKEN=your_verify_token_here


env

REDIS_URL=redis://redis:6379/0

WORKER_CONCURRENCY=5

PORT=3001

CONFIG_PATH=/app/config
SURVEYS_PATH=/app/surveys


---

make start-dev

npm install

cat .env

docker-compose exec mcp-server env | grep WHATSAPP


</details>

docker-compose config
```

---

- send-survey - Background job processing for large customer lists
- get-job-status - Monitor background job progress
- get-queue-stats - View job queue statistics

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "\ud83d\ude80 whatsapp flows api mcp server": {
            "whatsapp-flows-mcp-server": {
                "command": "docker",
                "args": [
                    "run",
                    "-d",
                    "-p",
                    "6379:6379",
                    "redis:7-alpine"
                ]
            }
        }
    }
}

McpServers

{
    "whatsapp-flows-mcp-server": {
        "command": "docker",
        "args": [
            "run",
            "-d",
            "-p",
            "6379:6379",
            "redis:7-alpine"
        ]
    }
}

<div align="center">

Docker
TypeScript
Redis
WhatsApp

A containerized Model Context Protocol (MCP) server for creating and managing WhatsApp surveys with ERP system integration

</div>

---

✨ Features

- 🐳 Dockerized Architecture - Complete containerized setup with Redis and background processing
- πŸ”§ Modular ERP Integration - Support for Business Central, SAP, Oracle, and custom ERP systems
- ⚑ Background Processing - Async job processing for handling large customer lists
- πŸ“± WhatsApp Flow Management - Create and send interactive surveys via WhatsApp Business API
- πŸ“Š Monitoring Tools - Built-in dashboards for job monitoring and Redis management
- πŸ”„ Development Support - Hot reload and development containers for rapid iteration

---

πŸš€ Quick Start

Prerequisites

Before you begin, ensure you have:
- βœ… Docker and Docker Compose installed
- βœ… WhatsApp Business API credentials
- βœ… Environment variables configured

1️⃣ Clone and Configure

```bash
git clone https://github.com/Ronnie-Leon76/whatsapp-flows-mcp-server.git
cd whatsapp-flows-mcp-server

No reviews yet β€” be the first

Sign in to leave a review

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

Email sign in

No reviews posted yet.