mcpField
W
WhatsApp MCP Server

WhatsApp MCP Server

Local
github.com/verissimomanoelCommunication0Updated 76w ago
Repository

About WhatsApp MCP Server

WhatsApp MCP Server connects to a WAHA instance to send WhatsApp messages and read contacts from a local JSON file. It is intended for setups with WAHA running separately and an active WhatsApp session.

Key features

  1. 01Send text messages through WAHA
  2. 02Read contacts from a local JSON file
  3. 03Expose tools and resources with FastMCP

Use cases

  1. 01Sending WhatsApp messages through WAHA
  2. 02Providing a local contacts list to an MCP client

MCP support

The MCP server exposes a message-sending tool and a contact-list resource to MCP clients.

#whatsapp#mcp#server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

WAHA MCP Server

Linguagem

Servidor MCP (Message Control Protocol) que interage com uma instância do WAHA (WhatsApp HTTP API) para enviar mensagens do WhatsApp e ler uma lista de contatos de um arquivo local.

Funcionalidades Principais ✨

  • Envio de Mensagens via WAHA: Expõe uma ferramenta (send_message) que permite enviar mensagens de texto para números de WhatsApp através de uma API WAHA local.
  • Leitura de Contatos: Expõe um recurso (read_resource) que lê um arquivo JSON local (data/contacts.json) para fornecer uma lista de contatos.
  • Integração com FastMCP: Construído sobre o framework FastMCP para expor ferramentas e recursos.

Tecnologias Utilizadas 🛠️

  • Linguagem: Python 3
  • Framework MCP: FastMCP (do pacote mcp-server)
  • Comunicação HTTP: Biblioteca requests (para interagir com a API WAHA)
  • Dependência Externa: WAHA (WhatsApp HTTP API) - Não incluído neste projeto, deve estar rodando separadamente.

Pré-requisitos 📋

Antes de começar, você precisará ter instalado em sua máquina:

  • Python (recomendado 3.7+)
  • pip (gerenciador de pacotes Python)
  • Uma instância do WAHA (WhatsApp HTTP API) rodando e acessível em http://localhost:3000.
    • Consulte a documentação do WAHA para instalação e configuração.
    • Certifique-se de que uma sessão do WhatsApp (nomeada default neste código) esteja ativa e conectada no WAHA.
  • Git (para clonar o repositório, se aplicável)

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.