AakibAnsarime/whatsapp-mcp-local-ollam
If you are the rightful owner of whatsapp-mcp-local-ollam and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
This is a Python-based WhatsApp automation tool that allows you to send messages programmatically using WhatsApp Web's interface.
WhatsApp Python Automation
This is a Python-based WhatsApp automation tool that allows you to send messages programmatically using WhatsApp Web's interface.
Features
- Send messages to individual contacts or groups
- Easy to set up and use
- Uses Python for automation
- Works with WhatsApp Web
Prerequisites
- Python 3.6 or higher
- Go (version 1.16 or higher)
- Chrome/Firefox browser
- Active WhatsApp account
- Internet connection
Windows-Specific Requirements
For Windows users, additional setup is required:
-
Install Go:
- Download Go from the official website
- Run the installer
- Add Go to your system PATH if not done automatically
- Verify installation by running
go versionin Command Prompt
-
Enable CGO:
- CGO is required for the WhatsApp bridge to work properly
- Open Command Prompt and run:
go env -w CGO_ENABLED=1
-
Install C Compiler:
- Download and install MSYS2
- Open MSYS2 and run:
pacman -S mingw-w64-x86_64-gcc - Add
C:\msys64\mingw64\binto your system PATH
Installation
- Clone this repository:
git clone [your-repository-url]
cd whatsapp-python
- Install the required dependencies:
pip install -r requirements.txt
Usage
- Navigate to the project directory:
cd whatsapp-bridge
- Run the WhatsApp bridge:
go run main.go
#this will start whatsapp mcp server
-
When running for the first time, you'll need to:
- Scan the QR code with your WhatsApp mobile app
- Wait for the authentication process to complete
- Keep your phone connected to the internet
-
To send a message, use the following format:
python whatsapp_message.py
#This will run ai with our mcp connection
send message to "recipient_name" "your message"
eg: send message to chau say hi /#remember to add contact manually to json so it will load it
How It Works
The application works by:
- Automating a web browser session
- Connecting to WhatsApp Web
- Authenticating via QR code (first time only)
- Locating the recipient in your contacts
- Sending the specified message using ollam
Important Notes
- Keep your WhatsApp phone app connected to the internet
- Don't close the server in terminal while sending messages
- Make sure the recipient is in your WhatsApp contacts
- The session needs to be re-authenticated periodically like 20 days
- For Windows users, ensure CGO is enabled and C compiler is properly configured
Troubleshooting
If you encounter issues:
- Ensure you have a stable internet connection
- Verify that your WhatsApp account is active
- Make sure the recipient's name matches exactly as it appears in your contacts
- Try re-running the script if authentication fails
Windows-Specific Issues
If you encounter errors like:
Binary was compiled with 'CGO_ENABLED=0': Make sure CGO is enabledgcc: command not found: Verify MSYS2 installation and PATHmissing go.sum entry: Rungo mod tidyin the whatsapp-bridge directory
Contributing
Feel free to:
- Report bugs
- Suggest features
- Submit pull requests
License
This project is licensed under the MIT License - see the LICENSE file for details.
Disclaimer
This tool is for educational purposes only. Please use responsibly and in accordance with WhatsApp's terms of service.
