mcpField
W
WhatsApp MCP Assistant (Client-Server)

WhatsApp MCP Assistant (Client-Server)

Local
github.com/NirsisrAI & Agents3Updated 80w ago
Repository

About WhatsApp MCP Assistant (Client-Server)

A client-server pipeline for sending and scheduling WhatsApp messages through natural-language requests. Mistral interprets intent, Twilio handles messaging, and a CLI client provides the interface.

Key features

  1. 01Interpret message intent with Mistral
  2. 02Send WhatsApp messages through Twilio
  3. 03Support message scheduling operations
  4. 04Provide a natural-language CLI client

Use cases

  1. 01Send WhatsApp messages from a CLI
  2. 02Request message scheduling in natural language

MCP support

The MCP server uses Mistral to route user intent to tools for sending or scheduling WhatsApp messages; the CLI client submits natural-language requests.

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

WhatsApp MCP Assistant (Client-Server)

This project builds a client-server pipeline to send and schedule WhatsApp messages using natural language. The server interprets user intent with Mistral's LLM and uses Twilio to perform the actual WhatsApp messaging.

Files

  • mcp_server.py: The main MCP server that uses Mistral for interpreting user input and calls Twilio to send messages.
  • mcp_client.py: Simple CLI client for interacting with the server using free-form natural language.
  • config.py: Stores API keys and constants including phone number config.

Server-Client Idea

The server parses your intent using Mistral's LLM and converts it into actionable instructions (like sending a message). The client is a CLI interface where you type prompts like "Send a message to Nir", and the backend handles the rest.

Twilio:

Twilio provides a programmable WhatsApp messaging API. It's used here to send messages or simulate scheduling via WhatsApp.

⚠️ WhatsApp 24-Hour Window Limitation (Twilio)

If you're using Twilio's WhatsApp API, note that freeform messages (i.e., regular text messages) are only allowed within a 24-hour window after the user last messaged your WhatsApp number.

If you attempt to send a message outside of that window, you'll see this error in your Twilio dashboard: "Failed to send freeform message because you are outside the allowed window. If you are using WhatsApp, please use a Message Template"

✅ To fix this:
💡 For local testing:

If you’re just testing this with your own number and it’s failing, make sure you’ve sent a message to the Twilio number from your own WhatsApp recently — that resets the 24-hour window.

MCP Idea:

The MCP Server wraps a function-calling capable LLM (Mistral) to dynamically route user intent to appropriate tools (send/schedule WhatsApp messages). The client allows CLI-based prompt entry.

How to Run

  1. Install dependencies:

    pip install twilio requests fastapi

  2. Update config.py with real values.

  3. Run the server:

    python mcp_server.py

  4. In another terminal, run the client:

    python mcp_client.py

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.