Back to Browse

Whatsapp Messaging Api MCP Server

CommunicationLow Risk8.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

Send WhatsApp messages from Claude. No Meta Business approval or WhatsApp Business account.

About

Send WhatsApp messages from Claude. No Meta Business approval or WhatsApp Business account.

Security Report

8.2
Low Risk8.2Low Risk

Well-structured MCP server with proper authentication, secure credential handling, and appropriate permissions for its communication purpose. The server requires API key authentication, uses environment variables correctly, and implements input validation via Zod. Minor code quality observations around error handling do not materially impact security. Package verification found 1 issue.

4 files analyzed · 4 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

RapidAPI key for the WhatsApp Messaging API. Free tier, no credit card.Required

Environment variable: WHATSAPP_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-jevil25-whatsapp-messaging-api-mcp": {
      "env": {
        "WHATSAPP_API_KEY": "your-whatsapp-api-key-here"
      },
      "args": [
        "-y",
        "whatsapp-messaging-api-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

WhatsApp Messaging API — MCP Server

Send WhatsApp messages from Claude, Cursor, or any MCP client. Create a session, scan a QR code, and send text, images and files — no Meta Business approval and no WhatsApp Business account required.

Wraps the WhatsApp Messaging API.

Quick start

  1. Get a free API key from RapidAPI — no credit card.

  2. Add this to your MCP client config (Claude Desktop: claude_desktop_config.json):

    {
      "mcpServers": {
        "whatsapp": {
          "command": "npx",
          "args": ["-y", "whatsapp-messaging-api-mcp"],
          "env": {
            "WHATSAPP_API_KEY": "your-rapidapi-key"
          }
        }
      }
    }
    
  3. Restart the client. Ask it to create a WhatsApp session and show you the QR code.

Nothing to install or build — npx fetches the package on first run.

Tools

ToolDescription
list_sessionsList all sessions on this API key
create_sessionCreate a new session
get_session_statusCheck a session's current status
get_qr_codeGet the QR code to authenticate a session
request_pairing_codeGet an 8-digit pairing code instead of a QR
check_contact_existsCheck if a phone number is on WhatsApp before sending
send_text_messageSend a text message
send_imageSend an image via URL
send_fileSend a file (PDF, document) via URL

Typical flow

  1. create_sessionget_qr_code → scan with WhatsApp (Settings → Linked Devices)
  2. get_session_status until it reports WORKING
  3. check_contact_exists, then send_text_message / send_image / send_file

Sessions stay authenticated between runs, so steps 1-2 are one-time per number.

Configuration

VariableRequiredDescription
WHATSAPP_API_KEYyesYour RapidAPI key. The server exits on startup if it is missing.

The key is read from the environment and sent only to the API host. It is never logged.

Local development

git clone https://github.com/jevil25/whatsapp-messaging-api-mcp.git
cd whatsapp-messaging-api-mcp
npm install
npm run dev      # runs src/index.ts directly via tsx, no build step
npm run build    # compile to dist/
npm test         # boots the built server and drives a real MCP handshake

npm test needs no credentials — it passes a dummy key, which gets far enough to list tools because nothing in the handshake makes an API call.

To point an MCP client at your local build, use "command": "node" with "args": ["/absolute/path/to/dist/index.js"].

See DEVELOPING.md for the release process.

Links

License

MIT

Reviews

No reviews yet

Be the first to review this server!