WhatsApp Python Automation

Name: WhatsApp Python Automation
Author: AakibAnsarime

@AakibAnsarime

About WhatsApp Python Automation

WhatsApp Messaging with MCP & Ollama This project integrates PraisonAI Agents with Ollama (llama3.2) and a Go-based WhatsApp bridge. It allows you to send WhatsApp messages using natural language through a local REST API, powered by an LLM and custom MCP tools.

#mcp #whatsapp #ollama #mcp-server

Basic information

Config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.