MCPSERV.CLUB
AakibAnsarime

WhatsApp MCP Local Ollam

MCP Server

Local WhatsApp automation via MCP server and web bridge

Stale(50)
0stars
0views
Updated Apr 14, 2025

About

A lightweight Python/Go based MCP server that automates WhatsApp Web to send messages programmatically. It runs locally, authenticates via QR code, and exposes an MCP interface for sending messages to contacts or groups.

Capabilities

Resources
Access data sources
Tools
Execute functions
Prompts
Pre-built templates
Sampling
AI model interactions

WhatsApp MCP Local Ollam – AI‑Driven WhatsApp Automation

The WhatsApp MCP Local Ollam server bridges the gap between conversational AI assistants and the WhatsApp messaging platform. By exposing a lightweight MCP interface, it allows an assistant such as Claude to send messages through WhatsApp Web without manual intervention. This solves a common developer pain point: integrating real‑world messaging into AI workflows while preserving the security and UX of a native WhatsApp experience.

At its core, the server launches a headless browser session that authenticates with WhatsApp Web via QR code. Once authenticated, the MCP exposes a simple command (“send message to <recipient> <text>”) that an AI client can invoke. The server then locates the specified contact or group, injects the message into WhatsApp’s DOM, and dispatches it. The entire process is wrapped in an MCP resource, so developers can invoke the tool from any AI‑enabled environment that understands the protocol. This eliminates the need for custom SDKs, OAuth flows, or third‑party APIs that often require costly subscriptions.

Key capabilities include:

  • Contact resolution – the tool reads your local WhatsApp contacts, ensuring that only valid recipients are targeted.
  • Session persistence – the browser session remains active for up to 20 days, after which re‑authentication via QR code is required. The MCP server handles this seamlessly by prompting the user only when necessary.
  • Cross‑platform support – while Windows requires CGO and a C compiler, the same Go binary runs unmodified on macOS or Linux, making it easy to deploy in diverse environments.
  • Developer‑friendly API – the MCP resource exposes a single, well‑documented command; no additional authentication headers or rate limits to manage.

Real‑world scenarios abound: a customer support AI can automatically send order confirmations or shipping updates; a marketing bot can push limited‑time offers to a broadcast list; an internal workflow tool can notify team members about task status changes. Because the server runs locally, sensitive data never leaves your network, addressing compliance concerns that often arise with cloud‑based messaging services.

Integrating the server into an AI pipeline is straightforward: the assistant calls the MCP “send message” resource, passing the recipient name and text. The server performs the browser automation behind the scenes, returning a success or error status that the assistant can relay to the user. This tight coupling allows developers to build conversational agents that feel natural and immediate, while leveraging WhatsApp’s ubiquity as a communication channel.