English Français العربية

Wsapi MCP

Community Other

WhatsApp through the WSAPI REST API: send messages and media, and manage chats, groups, communities and contacts on a connected number. Open source, self-hosted or managed.

Source code Documentation

Install

The installation steps are in the documentation below. Documentation

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. @wsapichat/mcp-server
  2. Installation
  3. Tool Filtering
  4. Configuration
  5. Development
  6. License
  7. Links
  8. Unreleased contract update

@wsapichat/mcp-server

A Model Context Protocol (MCP) server for WSAPI - the WhatsApp API Gateway. Enables LLMs to send messages, manage contacts and groups, handle communities and newsletters, post status updates, and more through WhatsApp.

For comprehensive documentation, see the WSAPI MCP Server guide.

Note: This project is not affiliated with, associated with, or endorsed by WhatsApp or Meta.

Installation

Prerequisites
  • Node.js >= 20.19.0
  • WSAPI account with API credentials (wsapi.chat)
Claude Desktop

Add to your Claude Desktop configuration:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "wsapi": {
      "command": "npx",
      "args": ["@wsapichat/mcp-server"],
      "env": {
        "WSAPI_API_KEY": "your_api_key_here",
        "WSAPI_INSTANCE_ID": "your_instance_id_here",
        "WSAPI_ENABLED_CATEGORIES": "messaging,contacts"
      }
    }
  }
}
Claude Code
claude mcp add wsapi -- npx @wsapichat/mcp-server \
  --env WSAPI_API_KEY=your_api_key_here \
  --env WSAPI_INSTANCE_ID=your_instance_id_here \
  --env WSAPI_ENABLED_CATEGORIES=messaging,contacts

Tool Filtering

The server exposes 80+ tools across 12 categories. To reduce context window usage, you can filter which tools are loaded using environment variables.

By category

Load only messaging and contact tools:

WSAPI_ENABLED_CATEGORIES=messaging,contacts

Available categories: messaging, contacts, groups, chats, session, users, communities, newsletters, status, calls, media

By individual tool

Load only specific tools:

WSAPI_ENABLED_TOOLS=whatsapp_send_text,whatsapp_send_image,whatsapp_get_contacts
Combined

Use categories as a base set and add individual tools from other categories:

WSAPI_ENABLED_CATEGORIES=messaging
WSAPI_ENABLED_TOOLS=whatsapp_get_contacts,whatsapp_get_chats

If neither variable is set, all tools are loaded.

Configuration

VariableRequiredDefaultDescription
WSAPI_API_KEYYes-Your WSAPI API key
WSAPI_INSTANCE_IDYes-Your WSAPI instance ID
WSAPI_BASE_URLNohttps://wsapi.chatWSAPI base URL
WSAPI_ENABLED_CATEGORIESNo(all)Comma-separated tool categories to load
WSAPI_ENABLED_TOOLSNo(all)Comma-separated tool names to load
LOG_LEVELNoinfoLogging level (error, warn, info, debug)

Development

git clone https://github.com/wsapi-chat/wsapi-mcp
cd wsapi-mcp
npm install
cp .env.example .env  # Edit with your credentials
npm run build
npm start

License

MIT - see LICENSE for details.

Unreleased contract update

The source covers 101 WhatsApp operations; Cloud Account/subscription and OSS admin APIs are outside this integration's scope. Changes in this working tree have not been published. See CHANGELOG.md.

Frequently asked questions

What is Wsapi MCP?

WhatsApp through the WSAPI REST API: send messages and media, and manage chats, groups, communities and contacts on a connected number. Open source, self-hosted or managed.

How do I install Wsapi MCP?

Follow the installation steps in its documentation, shown on this page and in its repository.

Is Wsapi MCP open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Wsapi MCP?

It is published by wsapi-chat. AI.tn lists it but does not maintain or endorse it.

From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.