English Français العربية

Wsapi MCP

Communauté Autres

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.

Code source Documentation

Installation

Les étapes d'installation sont dans la documentation ci-dessous. Documentation

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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.

Questions fréquentes

Qu'est-ce que 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.

Comment installer Wsapi MCP ?

Suivez les étapes d'installation de sa documentation, affichée sur cette page et dans son dépôt.

Wsapi MCP est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Wsapi MCP ?

Il est publié par wsapi-chat. AI.tn le référence sans le maintenir ni le recommander.

Issu des listes communautaires awesome-mcp-servers et du dépôt GitHub du projet. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.