WhatsApp MCP Assistant (Client-Server)

@Nirsisr

About WhatsApp MCP Assistant (Client-Server)

Config

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

{
  "mcpServers": {
    "MCPWhatsApp": {
      "command": "python",
      "args": [
        "mcp_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 WhatsApp MCP Assistant (Client-Server)?

The WhatsApp MCP Assistant (Client‑Server) is a natural‑language pipeline that sends and schedules WhatsApp messages. It uses a Mistral LLM to interpret user intent and Twilio’s WhatsApp API to perform the messaging.

How to use WhatsApp MCP Assistant (Client-Server)?

Install dependencies (pip install twilio requests fastapi), update config.py with your API keys and phone numbers, then run the server (python mcp_server.py) and the client (python mcp_client.py) in separate terminals. Type free‑form prompts like “Send a message to Nir.”

Key features of WhatsApp MCP Assistant (Client-Server)

Uses Mistral LLM for natural‑language intent parsing
Sends and schedules WhatsApp messages via Twilio
Client‑server architecture with a CLI interface
Configurable via config.py with API keys and numbers

Use cases of WhatsApp MCP Assistant (Client-Server)

Send a WhatsApp message by typing a plain‑English prompt
Schedule a WhatsApp message for a later time
Automate message dispatch as part of a larger toolchain

FAQ from WhatsApp MCP Assistant (Client-Server)

What is the 24‑hour window limitation?

Twilio’s WhatsApp API only allows free‑form text messages within 24 hours of the user’s last inbound message. Outside that window you must use a pre‑approved Message Template.

How can I fix an out‑of‑window error?

Create a pre‑approved template in your Twilio Console or send a message from your WhatsApp to the Twilio number to reset the 24‑hour window.

What dependencies does it require?

The server and client need Python packages twilio, requests, and fastapi. API keys for Twilio and Mistral must be set in config.py.

How do I run it locally?

After installing dependencies and configuring config.py, start the server (python mcp_server.py) and the client (python mcp_client.py) in separate terminals. Ensure your WhatsApp has recently messaged the Twilio number to avoid the 24‑hour window issue.

Does the server support authentication or multiple transports?

The README does not mention authentication or different transports. It uses a simple CLI client and a Python server with HTTP (FastAPI).

Frequently asked questions

What is the 24‑hour window limitation?

Twilio’s WhatsApp API only allows free‑form text messages within 24 hours of the user’s last inbound message. Outside that window you must use a pre‑approved Message Template.

How can I fix an out‑of‑window error?

Create a pre‑approved template in your [Twilio Console](https://www.twilio.com/console/sms/whatsapp/templates) or send a message from your WhatsApp to the Twilio number to reset the 24‑hour window.

What dependencies does it require?

The server and client need Python packages `twilio`, `requests`, and `fastapi`. API keys for Twilio and Mistral must be set in `config.py`.

How do I run it locally?

After installing dependencies and configuring `config.py`, start the server (`python mcp_server.py`) and the client (`python mcp_client.py`) in separate terminals. Ensure your WhatsApp has recently messaged the Twilio number to avoid the 24‑hour window issue.

Does the server support authentication or multiple transports?

The README does not mention authentication or different transports. It uses a simple CLI client and a Python server with HTTP (FastAPI).

Comments

Basic information

More AI & Agents MCP servers

Intervals.icu MCP Server

mvilanova

Model Context Protocol (MCP) server for connecting Claude and ChatGPT with the Intervals.icu API.

311

MCP-NixOS - Because Your AI Assistant Shouldn't Hallucinate About Packages

utensils

MCP-NixOS - Model Context Protocol Server for NixOS resources

739

Perplexity Ask MCP Server

ppl-ai

The official MCP server implementation for the Perplexity API Platform

2.4K

MCP-LLM Bridge

patruff

Bridge between Ollama and MCP servers, enabling local LLMs to use Model Context Protocol tools

976

🔎 GPT Researcher

assafelovic

An autonomous agent that conducts deep research on any data using any LLM providers

28.1K