WhatsApp MCP Server
Integrates WhatsApp with AI agents, enabling message sending, chat search, media sharing, approval workflows, and activity summaries via any MCP client.
Emerging. No concerning findings. Grades remain capped until the project builds reputation through adoption. Grades reflect the full trust pyramid: code, verification depth, and reputation. New projects cap at C until adoption is earned.
How we verified
Verified is a snapshot. Live keeps it current, and builds your track record.
⚡ Connect GitHub → continuous verification on every pushwhy connect →Who stands behind it
Malaccamaxgit
Source: Glama
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. Or connect your repo for our deepest verification, Live Monitored: read-only, revoke anytime. What we access →
Install from
The grade above is for the source repository. Registries can serve a different version, so we mark the ones we were not able to read.
ALLOWED_CONTACTSContact whitelist — restrict who can receive messages ()AUDIT_DB_PATHAudit log database path /data/audit/audit.dbAUDIT_FALLBACK_PATHAUTH_LINK_TIMEOUT_SECDefault max seconds to wait for link when waiting (15–600) 120AUTH_POLL_INTERVAL_SECDefault seconds between connection checks when waiting (2–60) 5AUTH_READY_DELAY_MSAUTH_WAIT_FOR_LINKDefault: after authenticate shows code/QR, wait and poll until linked (false = return immediately; recommended for most clients to avoid tool-call timeouts) falseAUTO_CONNECT_ON_STARTUPAUTO_READ_RECEIPTSAuto-read incoming messages (senders see blue checkmarks immediately) trueDATA_ENCRYPTION_KEYSecurity posture: Running without is an insecure mode. Only do this with an explicit operator override and documented risk acceptance.DISABLED_TOOLSComma-separated tool names to disable ""DOWNLOAD_RATE_LIMIT_PER_MINMax media downloads per minute 30HOSTNAMEMESSAGE_RETENTION_DAYSAuto-purge — messages and media auto-deleted after retention period ()PRESENCE_MODEOnline presence: available or unavailable availableRATE_LIMIT_PER_MINMax outbound messages per minute 60SEND_READ_RECEIPTSSend read receipts to WhatsApp when mark_messages_read is called trueSTORE_DB_PATHSTORE_PATHSession + message database directory /data/sessionsWELCOME_GROUP_NAMEWhatsApp group created on first connection (empty = disable) WhatsAppMCPAll four hints declared on every tool
7/7 tools missing one or more hints — list_chats (missing: destructiveHint, idempotentHint, openWorldHint); catch_up (missing: destructiveHint, idempotentHint, openWorldHint); search_contacts (missing: destructiveHint, idempotentHint, openWorldHint), +4 more. OpenAI's directory rejects tools where any of the four hints are missing or non-boolean.
For every tool, set all four hints (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) to explicit true/false values that match the handler’s actual behaviour.
Tool handlers catch errors
Only 3/7 tool handlers wrap calls in try/catch (43%)
Wrap each tool handler body in try/catch and return a structured error response.
Shell command execution
16 child_process calls — runs shell commands
Prefer library functions over shell-outs. If you must shell out, ensure all inputs are properly escaped.
Claim the listing to review these findings one by one and send us a correction where you disagree, straight to the team. Claiming also means we tell you when the grade moves, and reach you first if we find anything urgent.
[](https://m8ven.ai/mcp/malaccamaxgit/whatsapp-mcp-docker)?variant=verified to the badge URL.Vetting this one by hand? Tool Check is an MCP that scores other MCPs. Add it once and ask Claude, ChatGPT, or any MCP client to grade a server, surface CVEs, check the publisher, and suggest safer alternatives — before you install.
https://m8ven.ai/api/mcp/tool-check