</>MCP Agents Market
MCP Server

wa-automate-nodejs

by open-wa3.7kTypeScriptUpdated 2026-09-01

💬 🤖 The most reliable tool for chatbots with advanced features. Be sure to 🌟 this repository for updates!

Claude DesktopCursorWindsurf

wa-automate-nodejs is a Node.js toolkit for WhatsApp Web automation that includes a built-in MCP server, enabling AI agents to interact with WhatsApp accounts programmatically. The package converts a WhatsApp account into an API, bot runtime, webhook bridge, and AI tool surface, exposing WhatsApp operations as discoverable tools through the Model Context Protocol. It supports multiple deployment modes including Easy API (HTTP server), embedded runtime, and remote client connections, with the MCP integration allowing AI assistants like Claude, Cursor, and Windsurf to send messages, manage contacts, and automate WhatsApp workflows directly.

Key Features

Built-in MCP server exposing WhatsApp automation methods as AI-callable tools via Streamable HTTP transport
Easy API mode launches HTTP server with auto-generated OpenAPI docs, Swagger JSON, and Postman collections
Support for multiple browser automation drivers including Puppeteer, Playwright, and Lightpanda
Plugin architecture with built-in integrations for webhooks, Chatwoot, S3, and Cloudflare session proxy
Multi-session support with named accounts and isolated runtime instances
SocketClient library for remote consumption of WhatsApp runtime without embedding browser automation
Authentication via QR code scanning or link-code login with configurable timeouts
Dashboard at /dashboard/mcp showing connection status, configuration snippets, and live tool metadata

Use Cases

  • 01Enabling AI agents to send WhatsApp notifications, respond to customer inquiries, and manage conversations autonomously
  • 02Building customer support systems that sync WhatsApp messages into CRMs and helpdesk platforms
  • 03Automating order confirmations, booking notifications, and delivery updates via WhatsApp from internal business systems
  • 04Creating chatbots that react to WhatsApp messages, group activities, and runtime events with custom logic
  • 05Bridging WhatsApp into low-code automation tools through webhook integrations
  • 06Providing AI assistants like Claude with WhatsApp access for multi-channel communication workflows

Related MCP Servers

View more

wa-automate-nodejs — FAQ

What is wa-automate-nodejs MCP server?+

It's a Model Context Protocol server built into the wa-automate-nodejs toolkit that exposes WhatsApp automation capabilities as tools AI agents can discover and call. When enabled, it allows assistants like Claude, Cursor, and Windsurf to send messages, manage contacts, and automate WhatsApp workflows through the MCP protocol.

How do I install and enable the MCP server?+

Create a wa.config.mjs file with mcp.enabled set to true, then run the Easy API with npx @open-wa/wa-automate@alpha --config ./wa.config.mjs. The MCP endpoint will be available at http://localhost:8080/mcp after authentication completes.

Which AI clients work with this MCP server?+

The MCP server works with Claude Desktop, Cursor, and Windsurf. Configure the client by pointing it to the MCP endpoint URL (http://localhost:8080/mcp) and including the X-API-Key header for authentication.

Do I need API keys or a WhatsApp account?+

You need a WhatsApp account for authentication (QR scan or link-code login) and must set an API key to protect the Easy API and MCP endpoints. Optional license keys unlock additional features.

Is wa-automate-nodejs free to use?+

The software is available under the Hippocratic + Do Not Harm license. The v5 alpha is currently free to use, though paid support, consulting, and license keys for advanced features are available. This is unofficial software not affiliated with WhatsApp or Meta.

Is version 5 stable for production use?+

No, version 5 is currently in alpha and may have issues. The maintainers recommend using the stable v4.76.0 release for production systems unless you are explicitly testing or contributing to v5 development.

How do I install wa-automate-nodejs?+

Open the source repository on GitHub and follow its README. wa-automate-nodejs is a mcp server — MCP Agents Market links you directly to the official repo.

Is wa-automate-nodejs free?+

wa-automate-nodejs is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.

Related searches