loglux/whatsapp-mcp-stream

Overview

A WhatsApp MCP server built with Streamable HTTP transport. It uses Baileys for WhatsApp connectivity and includes a web admin UI. Bidirectional media upload and download are supported.

Best for

Best for
Developers who need to link WhatsApp with MCP-based AI tools and want a ready-made server with a basic admin UI

Use cases

• Connecting WhatsApp to MCP-compatible AI agents for automated messaging
• Handling media files such as images and documents within WhatsApp conversations
• Managing multiple WhatsApp sessions through a web admin interface

How to use

Install

docker compose build && docker compose up -d

Tools exposed

• get_qr_code
• check_auth_status
• logout
• search_contacts
• resolve_contact
• get_contact_by_id
• get_profile_pic
• get_group_info
• list_chats
• get_chat_by_id
• list_groups
• get_direct_chat_by_contact_number
• get_chat_by_contact
• analyze_group_overlaps
• find_members_without_direct_chat
• find_members_not_in_contacts
• run_group_audit
• list_messages
• search_messages
• get_message_by_id

Example client config

{\n  "media_public_base_url": "http://localhost:3003/media/",\n  "upload_max_mb": 100,\n  "upload_enabled": true,\n  "max_files_per_upload": 10,\n  "require_upload_token": false,\n  "upload_token": "your_secret_token",\n  "auto_download_media": true,\n  "auto_download_max_mb": 5\n}

Notes

A WhatsApp MCP server built with Streamable HTTP transport. It uses Baileys for WhatsApp connectivity and includes a web admin UI. Bidirectional media upload and download are supported.

4 stars on GitHub. Last updated 2026-05-31. Licensed MIT.

Use cases

• Connecting WhatsApp to MCP-compatible AI agents for automated messaging
• Handling media files such as images and documents within WhatsApp conversations
• Managing multiple WhatsApp sessions through a web admin interface

Pros

• Supports both upload and download of media for rich interactions
• Includes a web admin UI for easier session management
• Uses Streamable HTTP transport for compatibility with MCP clients

Cons

• Relies on Baileys, a third-party library that may break with WhatsApp updates
• Low community adoption (4 stars on GitHub) suggests limited testing and support
• Not an official WhatsApp integration, so long-term reliability is uncertain

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.