mcp-whatsapp-server

mcp-whatsapp-server

0
communication

This server enables MCP-compatible AI assistants to communicate with WhatsApp contacts via the Waha API. It offers functionalities such as WhatsApp connection status verification and message sending by phone number and contact name.

MCP WhatsApp Server

A server based on the Model Context Protocol (MCP) for integration with WhatsApp through the Waha API.

Project Overview

This server allows AI assistants compatible with MCP, like Claude, to interact directly with WhatsApp contacts. It uses the Waha API as a backend for communication with WhatsApp Web.

Features

  • Connection status check for WhatsApp
  • Send messages via phone number
  • Send messages via registered contact name
  • Manage contacts by name
  • View server settings

Requirements

  • Python 3.7+
  • Running Waha API
  • MCP Library (Fast MCP)

Usage

  1. Start the Waha API.
  2. Run the MCP server.
  3. Use the server with an MCP-compatible client (like Claude Desktop).

MCP Resources Available

Resources

  • waha://config - Waha API settings
  • waha://status - Current WhatsApp connection status
  • waha://contacts - List of contacts mapped by name

Tools

  • verify_whatsapp_connection() - Checks current connection status
  • send_whatsapp_message(number, message) - Send message by number

Contributions

Contributions are welcome! Feel free to open issues or pull requests.

License

This project is licensed under .