WhatsApp Python Automation

What is WhatsApp Python Automation?

WhatsApp Python Automation is an MCP (Model Context Protocol) server that lets you send WhatsApp messages programmatically using a Python script. It automates a WhatsApp Web session, authenticates via QR code, and provides a bridge (Go-based) that a Python AI client can connect to for sending messages.

How to use WhatsApp Python Automation?

Clone the repository, install Python dependencies with pip install -r requirements.txt, then start the Go MCP server with go run main.go. For the first run, scan the QR code with your WhatsApp mobile app. After authentication, run python whatsapp_message.py to send messages using the format send message to "recipient_name" "your message". Contacts must be added manually to a JSON file.

Key features of WhatsApp Python Automation

• Send messages to individual contacts or groups
• Uses WhatsApp Web’s browser automation
• Easy setup with Python and Go
• Authenticate once, session lasts ~20 days
• Works with an AI client over MCP

Use cases of WhatsApp Python Automation

• Automate sending messages from a Python AI assistant
• Programmatically notify contacts or groups
• Integrate WhatsApp messaging into custom workflows

FAQ from WhatsApp Python Automation

What are the prerequisites?

Python 3.6 or higher, Go version 1.16 or higher, a Chrome or Firefox browser, an active WhatsApp account, and a stable internet connection. Windows users also need to enable CGO and install a C compiler via MSYS2.

How do I authenticate for the first time?

Run the Go bridge; a QR code will appear in the terminal. Scan it with your WhatsApp mobile app (Settings → Linked Devices → Link a Device). Keep your phone connected to the internet.

Why must my phone stay connected?

WhatsApp Web mirrors your phone’s connection. If your phone goes offline, the bridge loses its session and cannot send messages.

How long does the session last?

The authenticated session typically lasts about 20 days before requiring re-authentication.

What should I do if I see Windows-specific errors?

Ensure CGO is enabled (go env -w CGO_ENABLED=1) and that MSYS2 is installed with the GCC compiler added to your system PATH. If a go.sum entry is missing, run go mod tidy in the whatsapp-bridge directory.