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

Nero AI Image Processing

nero-com

We provide AI-powered tools for image enhancement, upscaling, background removal, photo restoration, colorization, denoising, and compression. All features are available through our API documentation.

Lumify Sports Intelligence

Lumify

Agent-ready sports intelligence API: live scores, odds, line movement, public betting splits, and explainable bet confidence — via 16 MCP tools at https://lumify.ai/mcp. Get a free key instantly — no signup, email, or ca

XDC AI

XDC AI is a remote MCP server available at https://xdcai.tech.

q-ring

I4cTime

Quantum-inspired keyring for AI coding agents. Secure secrets with superposition, entanglement, tunneling, and teleportation — CLI + 44 MCP tools.

Agentic Atlas

Avery Jones

Consult field-tested agent-system design patterns through 8 hosted, read-only tools for orientation, deep reading, relationships, provenance, glossary terms, and publication decisions.