MCP WhatsApp Server

@pedsanches

About MCP WhatsApp Server

No overview available yet

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Frequently asked questions

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.