mcpField
W
WhatsApp Messaging API

WhatsApp Messaging API

Local
github.com/jevil25Communication0Updated 8w ago
Repository

About WhatsApp Messaging API

WhatsApp Messaging API is an MCP server for sending WhatsApp messages from clients such as Claude and Cursor. It supports session setup and text, image, and file delivery without Meta Business approval or a WhatsApp Business account.

Key features

  1. 01Create and check sessions
  2. 02Authenticate with QR or pairing code
  3. 03Check WhatsApp number availability
  4. 04Send text, images, and files

Use cases

  1. 01Message WhatsApp contacts from Claude
  2. 02Send images or PDF files to contacts
  3. 03Check whether a number is reachable before sending

MCP support

The MCP server exposes tools for session management, contact checks, and message delivery. Clients connect over stdio and require a RapidAPI key.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "jevil25-whatsapp-messaging-api": {
      "command": "npx",
      "args": [
        "-y",
        "whatsapp-messaging-api-mcp"
      ],
      "env": {
        "WHATSAPP_API_KEY": "<WHATSAPP_API_KEY>"
      }
    }
  }
}
Run commandnpx -y whatsapp-messaging-api-mcp
Environment variables to set
WHATSAPP_API_KEYSecretRapidAPI key for the WhatsApp Messaging API. Free tier, no credit card.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmwhatsapp-messaging-api-mcp1.0.3

Tools

9

Saved tool list · updated 2w ago

This tool takes no parameters.

Details

From the project 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_session → get_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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.