Overview
What is WhatsApp MCP Server?
A FastMCP server that provides WhatsApp messaging capabilities using the Z-API.io service. It allows you to send WhatsApp messages programmatically through a simple interface, intended for developers needing asynchronous messaging and contact management.
How to use WhatsApp MCP Server?
Clone the repository, install dependencies using UV, set the required environment variables (INSTANCE, TOKEN, CLIENT_TOKEN) either in your environment or a .env file, create a data/contacts.json file with contact names and phone numbers, then run the server with python waha_mcp_server.py.
Key features of WhatsApp MCP Server
- Send WhatsApp messages via Z-API.io
- Contact management through a JSON file
- Asynchronous message handling
- Error logging and handling
- Configuration via environment variables
Use cases of WhatsApp MCP Server
- Automate sending WhatsApp notifications to customers
- Integrate WhatsApp messaging into existing Python applications
- Manage and send messages to a known contact list
- Build a simple chatbot backend with Z‑API.io
FAQ from WhatsApp MCP Server
What are the prerequisites for this server?
Python 3.x, access to the Z‑API.io service, and valid Z‑API.io credentials (Instance ID, Token, and Client Token).
Where are contacts stored?
Contacts are stored in a local JSON file at data/contacts.json with a simple name-to-phone-number mapping.
How do I authenticate with Z‑API.io?
Set the environment variables INSTANCE, TOKEN, and CLIENT_TOKEN with your Z‑API.io credentials.
What runtime dependencies does it require?
The server requires Python 3.x and the UV package manager for installation; no other runtime environment is mentioned.
Does the server support receiving messages or only sending?
The README only describes sending messages; no receiving or webhook capabilities are mentioned.
