Set up
Skills are installed by placing their folder where your agent loads skills.
The download comes from github.com/daedalus/mcp-whatsapp itself, not from our server, so what you get is exactly what its author published.
Install instructions come from the README
Skills do not use an MCP config. Follow the steps in the README below.
README
synced Oct 15, 2026mcp-whatsapp
MCP server exposing WhatsApp bot functionality with support for multiple adapters.
Install
pip install mcp-whatsapp
WhatsApp Adapters
This package supports two WhatsApp adapters:
- pywhatkit: Uses WhatsApp Web (default, easier setup)
- whatsapp-business: Uses WhatsApp Business API (production-ready)
Install with adapter dependencies:
# For pywhatkit (WhatsApp Web)
pip install mcp-whatsapp[pywhatkit]
# For WhatsApp Business API
pip install mcp-whatsapp[whatsapp-business]
Usage
Setting the adapter
Set the adapter using the WHATSAPP_ADAPTER environment variable:
export WHATSAPP_ADAPTER=pywhatkit # Default
export WHATSAPP_ADAPTER=whatsapp-business
WhatsApp Business API Configuration
For WhatsApp Business API, set these environment variables:
export WHATSAPP_PHONE_NUMBER_ID=your_phone_number_id
export WHATSAPP_ACCESS_TOKEN=your_access_token
export WHATSAPP_VERIFY_TOKEN=your_verify_token
Running as MCP Server
mcp-whatsapp
MCP Tools
| Tool | Description |
|---|---|
send_message | Send a text message to a phone number |
send_media | Send media (image, document) to a phone number |
send_location | Send a location to a phone number |
connect_whatsapp | Connect to the WhatsApp service |
disconnect_whatsapp | Disconnect from the WhatsApp service |
MCP Resources
| Resource | Description |
|---|---|
whatsapp://status | Get the current connection status |
whatsapp://config | Get the adapter configuration |
mcp-name
io.github.daedalus/mcp-whatsapp
Development
git clone https://github.com/daedalus/mcp-whatsapp.git
cd mcp-whatsapp
pip install -e ".[test]"
# run tests
pytest
# format
ruff format src/ tests/
# lint
ruff check src/ tests/
# type check
mypy src/
License
MIT