@waboom/mcp

MCP server for waboom — send WhatsApp messages and manage a waboom instance from any MCP client (Claude Desktop, Claude Code, Cursor, …).

It is a thin, stateless client of the waboom REST API. It holds no WhatsApp session; waboom does. You bring an API token and an instance id.

Configure

Add to your MCP client config (Claude Desktop / Code example):

{
  "mcpServers": {
    "waboom": {
      "command": "npx",
      "args": ["-y", "@waboom/mcp"],
      "env": {
        "WABOOM_TOKEN": "wbo_your_org_api_key_or_instance_token",
        "WABOOM_INSTANCE_ID": "your-instance-id",
        "WABOOM_BASE_URL": "https://api.waboom.it"
      }
    }
  }
}

WABOOM_BASE_URL is optional (defaults to https://api.waboom.it).

Tools

| Tool | Purpose | |------|---------| | waboom_send_text | Send a text message | | waboom_send_media | Send image/video/audio/document (url or base64) | | waboom_send_location | Send a location | | waboom_send_reaction | React to a message | | waboom_check_numbers | Check if numbers are on WhatsApp (max 100) | | waboom_mark_read | Mark messages read | | waboom_send_typing | Show typing/recording | | waboom_list_chats | List recent chats | | waboom_get_messages | Fetch a chat's messages | | waboom_download_media | Download media of a received message | | waboom_list_groups | List groups | | waboom_get_status | Instance connection state |

Phone numbers are accepted as international digits (e.g. 393331234567) or full JIDs.

Develop

npm install
npm run build
WABOOM_TOKEN=... WABOOM_INSTANCE_ID=... node dist/index.js