MCP WhatsApp Server

Name: MCP WhatsApp Server
Author: pedsanches

@pedsanches

代码仓库

关于 MCP WhatsApp Server

暂无概览

基本信息

分类

沟通协作

运行时

python

传输方式

stdio

发布者

pedsanches

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-whatsapp-server": {
      "command": "python",
      "args": [
        "server.py"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is MCP WhatsApp Server?

MCP WhatsApp Server is an MCP (Model Context Protocol) server that integrates with WhatsApp via the Waha API, enabling AI assistants (such as Claude) to interact directly with WhatsApp contacts.

How to use MCP WhatsApp Server?

Install dependencies with pip install -r requirements.txt, set environment variables (WAHA_API_URL, WAHA_SESSION_ID, optional CONTATOS_FILE) in a .env file, configure contacts in a contatos.json file, start the Waha API, then run python server.py. Connect any MCP-compatible client to the server.

Key features of MCP WhatsApp Server

Check WhatsApp connection status
Send messages by phone number
Send messages by saved contact name
Manage contacts by name in a JSON file
View server configuration and contact list

Use cases of MCP WhatsApp Server

An AI assistant sending WhatsApp notifications to customers
Automating customer support replies based on contact names
Sending personalized bulk messages to a managed contact list
Monitoring the WhatsApp connection status remotely

FAQ from MCP WhatsApp Server

What are the system requirements for MCP WhatsApp Server?

Python 3.7 or higher, a running instance of the Waha API, and the Fast MCP library.

How do I configure MCP WhatsApp Server?

Set the environment variables WAHA_API_URL (default http://localhost:3000), WAHA_SESSION_ID (default default), and optionally CONTATOS_FILE in a .env file. Define contacts in a contatos.json mapping names to phone numbers.

How do I manage contacts in MCP WhatsApp Server?

Contacts are stored in a JSON file specified by CONTATOS_FILE (default contatos.json). You can also view the current contact list through the waha://contatos resource.

What resources and tools does MCP WhatsApp Server expose?

Resources: waha://configuracao (Waha API settings), waha://status (connection status), waha://contatos (contact list). Tools: verificar_conexao_whatsapp(), enviar_mensagem_whatsapp(numero, mensagem), and enviar_mensagem_por_nome(nome, mensagem).

How do I start MCP WhatsApp Server?

After installing dependencies and configuring the .env file, start the Waha API first (see its official instructions), then run python server.py in the project directory.