A self-hosted WhatsApp bridge that exposes a stdio MCP server with ~20 tools for reading conversations, sending messages, managing groups, contacts, and aliases, enabling AI agents to operate WhatsApp directly.
Claim it to get a verified publisher badge, a free copy of our full audit findings, and direct contact for any high-priority issues we find.
Install from
M8ven verifies MCPs across every public registry — install directly from whichever one you prefer.
process.env. You'll be asked to provide them before it can run.API_TOKEN— generates and writes it to .envAUTOREPLY_ALLOW_GROUP_AUTO— Groups group chats are never auto-answered unless =1, and even then only when the operator is explicitly @-mentionedAUTOREPLY_AUTO_SEND_COOLDOWN_MS— Cooldown an auto-send already happened in this chat within (default 10 min)AUTOREPLY_CLAUDE_BINAUTOREPLY_DATA_DIRAUTOREPLY_DEFAULT_SESSIONAUTOREPLY_HOSTAUTOREPLY_LLM_API_KEY— anthropic Anthropic API (official SDK) or ANTHROPIC_API_KEYAUTOREPLY_LLM_BASE_URL— openai any OpenAI-compatible endpoint - OpenAI, OpenRouter, Groq, Mistral, Ollama, LM Studio + AUTOREPLY_LLM_MODELAUTOREPLY_LLM_MODEL— openai any OpenAI-compatible endpoint - OpenAI, OpenRouter, Groq, Mistral, Ollama, LM Studio AUTOREPLY_LLM_BASE_URL +AUTOREPLY_LLM_PROVIDER— Any of them. in .env picks the backend:AUTOREPLY_MIN_CONFIDENCE— Confidence confidence <AUTOREPLY_MODELAUTOREPLY_NOTIFY_CHANNELAUTOREPLY_NOTIFY_WA_SESSIONAUTOREPLY_NOTIFY_WA_TOAUTOREPLY_NOTIFY_WEBHOOK_TOKENAUTOREPLY_NOTIFY_WEBHOOK_URLAUTOREPLY_PORTAUTOREPLY_SECOND_BRAIN_ROOTAUTOREPLY_SLACK_BOT_TOKENAUTOREPLY_SLACK_CHANNELAUTOREPLY_SLACK_WEBHOOK_URLAUTOREPLY_STYLE_CORPUS_PATHAUTOREPLY_TELEGRAM_BOT_TOKENAUTOREPLY_TELEGRAM_CHAT_IDAUTOREPLY_TOKEN— TOKEN=$(grep '^=' .env cut -d= -f2)AUTOREPLY_WA_API_BASEAUTOREPLY_WA_API_TOKENHOST— 127.0.0.1 Use 0.0.0.0 only behind a reverse proxy. Set WA_ALLOW_PUBLIC=1 to override the loopback guard.OPENAI_API_KEY— (none) Used by npm run transcribe-backlog to transcribe past audio messages.PORTWA_ALLOW_PUBLIC— HOST 127.0.0.1 Use 0.0.0.0 only behind a reverse proxy. Set =1 to override the loopback guard.WA_BACKUP_DIRWA_BACKUP_KEEPWA_CONTACTS_TSVWA_DB_PATHWA_FORCE_HISTORY_SYNC_ON_RESTOREWA_FORCE_REDUMPWA_KEEP_CONTACTS_TSVWA_TZ— detects your system timezone and writes it as to .env (e.g. Europe/Berlin)WA_UPDATE_BRANCHWEBHOOK_TOKEN— If is set, it arrives as Authorization: Bearer <token> so the receiver can verify origin. Three attempts, 1s/3s backoff, 5s timeout per attempt. Outbound sends do not fire the webhook.WEBHOOK_URL— POST /v1/webhook/test — Pings the configuredWHATSAPP_BRIDGE_BASEWHATSAPP_BRIDGE_TOKENWHATSAPP_BRIDGE_URL[](https://m8ven.ai/mcp/obirimensah05-whatsapp-bridge-1sdhxm)