WhatsApp MCP Assistant (Client-Server)

Name: WhatsApp MCP Assistant (Client-Server)
Author: Nirsisr

@Nirsisr

Repository

About WhatsApp MCP Assistant (Client-Server)

Basic information

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).

Comments

More AI & Agents MCP servers

Shell and Coding agent for Claude and other mcp clients

rusiaaman

Shell and coding agent on mcp clients

666

🔎 GPT Researcher

assafelovic

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

28.1K

21st.dev Magic AI Agent

21st-dev

It's like v0 but in your Cursor/WindSurf/Cline. 21st dev Magic MCP server for working with your frontend like Magic

5.3K

LinkedIn MCP Server

stickerdaniel

Open-source MCP server for LinkedIn. Give Claude and any MCP-compatible AI agent access to profiles, companies, jobs, and messages.

2.7K

Model Context Protocol for Unreal Engine

chongdashu

Enable AI assistant clients like Cursor, Windsurf and Claude Desktop to control Unreal Engine through natural language using the Model Context Protocol (MCP).

2.0K