{"name":"io.github.mario-andreschak/mcp-whatsapp-web","slug":"mario-andreschak-mcp-whatsapp-web","title":"WhatsApp Web MCP Server","description":"WhatsApp MCP via web.js or browserless Baileys: messages, media, chats, groups and contacts","url":"https://mcp.market/server/mario-andreschak-mcp-whatsapp-web","rating":null,"grade":"A","score":92,"certified":false,"status":"active","category":"other","tags":[],"presence":{"score":40,"stars":25,"forks":8,"downloads_week":40,"last_push_at":"2026-09-17T14:07:32.000Z","license":"MIT"},"uptime":null,"claimed":false,"transport":"npm","callable_via_gateway":false,"default_price_micros":0,"repository":"https://github.com/mario-andreschak/mcp-whatsapp-web","website":"https://github.com/mario-andreschak/mcp-whatsapp-web","version":"1.2.0","remotes":[],"packages":[{"registryType":"npm","registryBaseUrl":"https://registry.npmjs.org","identifier":"mcp-whatsapp-web","version":"1.2.0","runtimeHint":"npx","transport":{"type":"stdio"},"environmentVariables":[{"description":"WhatsApp backend: webjs uses a persistent browser profile; baileys connects without a browser and requires separate pairing","format":"string","default":"webjs","choices":["webjs","baileys"],"name":"WHATSAPP_BACKEND"},{"description":"Baileys credentials and synchronized history directory (default: <working directory>/baileys-sessions). Use a private absolute path, owned by one server process.","format":"filepath","name":"BAILEYS_SESSION_DIR"},{"description":"Log level for the log file (logs/mcp-whatsapp.log)","format":"string","default":"info","choices":["trace","debug","info","warn","error","fatal"],"name":"LOG_LEVEL"},{"description":"Log level for stderr (visible in most MCP client logs)","format":"string","default":"warn","choices":["trace","debug","info","warn","error","fatal"],"name":"LOG_STDERR_LEVEL"},{"description":"webjs only: set to false to show the browser window instead of running headless","format":"boolean","name":"WHATSAPP_HEADLESS"},{"description":"webjs only: explicitly disable the browser sandbox for containers that require it. The sandbox is enabled by default.","format":"boolean","default":"false","name":"WHATSAPP_NO_SANDBOX"},{"description":"webjs only: browser executable. Chrome and Edge are auto-detected; set this to use a specific browser. Chrome/Edge is required for sending videos and GIFs.","format":"filepath","name":"BROWSER_EXECUTABLE_PATH"},{"description":"webjs only: persistent browser profile directory (default: <working directory>/whatsapp-sessions)","format":"filepath","name":"WHATSAPP_SESSION_DIR"},{"description":"Phone number pairing: when set (international, symbol-free format, e.g. 4915112345678), an 8-character pairing code is logged to stderr on startup instead of relying on the QR code","format":"string","name":"WHATSAPP_PAIRING_PHONE_NUMBER"},{"description":"Path to an ffmpeg binary (only needed to override the ffmpeg installed automatically via the ffmpeg-static npm package)","format":"filepath","name":"FFMPEG_PATH"},{"description":"webjs only: pin the WhatsApp Web version if a WhatsApp-side update breaks the client.","format":"string","name":"WA_WEB_VERSION"},{"description":"webjs only: connection health check interval in milliseconds (<=0 disables)","format":"number","default":"60000","name":"HEALTH_CHECK_INTERVAL_MS"},{"description":"How long tool calls wait for the WhatsApp client to become ready before erroring","format":"number","default":"45000","name":"TOOL_READY_TIMEOUT_MS"},{"description":"When set, additionally exposes the MCP endpoint at http://127.0.0.1:<port>/mcp (Streamable HTTP) from the same process","format":"number","name":"MCP_HTTP_PORT"},{"description":"Bind address for the HTTP endpoint (do not expose publicly; the endpoint controls your personal WhatsApp account)","format":"string","default":"127.0.0.1","name":"MCP_HTTP_HOST"},{"description":"Enable OAuth for the HTTP endpoint: /mcp requires a bearer token and clients authenticate via a browser page showing the WhatsApp QR code / pairing form","format":"boolean","name":"MCP_OAUTH"}]}],"tools":[{"name":"ping","description":"","write_action":false,"price_micros":0,"input_schema":null}],"scan":{"score":92,"grade":"A","scanned_at":"2026-09-20T11:37:25.473Z","report":{"scannerVersion":"0.1.9","scannedAt":"2026-09-20T11:37:25.378Z","components":{"code":{"score":25,"max":25,"notes":["43 source files scanned"]},"reliability":{"score":-1,"max":20,"notes":["no gateway calls yet and no remote to probe"]},"poisoning":{"score":-1,"max":15,"notes":["tools not inspected (local package is not executed); not counted"]},"auth":{"score":12,"max":15,"notes":["local package, no credentials required"]},"maintenance":{"score":15,"max":15,"notes":["last push 3 days ago"]},"identity":{"score":8,"max":10,"notes":["registry namespace matches repository owner","GitHub account older than a year"]}},"findings":[],"inputs":{"packages":[{"registryType":"npm","identifier":"mcp-whatsapp-web","version":"1.2.0","found":true,"license":"MIT","hasInstallScripts":false,"dependencyCount":16,"publishedAt":"2026-09-05T19:04:18.962Z","repositoryUrl":"git+https://github.com/mario-andreschak/mcp-whatsapp-web.git","weeklyDownloads":40}],"repo":{"found":true,"owner":"mario-andreschak","repo":"mcp-whatsapp-web","archived":false,"pushedAt":"2026-09-17T14:07:32Z","stars":25,"forks":8,"openIssues":2,"ownerType":"User","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/196235471?v=4","ownerCreatedAt":"2025-01-23T18:29:12Z","license":"MIT"},"icon":{"url":"https://raw.githubusercontent.com/mario-andreschak/mcp-whatsapp-web/main/public/logo.png","source":"registry","width":391,"height":389},"presence":{"stars":25,"forks":8,"downloadsWeek":40,"license":"MIT","lastPushAt":"2026-09-17T14:07:32.000Z","score":40}}}},"grade_history":[],"reviews":[]}