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.