Whatsapp Whatsmeow

VIREN27791stars

MCP server that connects Opencode to your personal WhatsApp — read chat history, search contacts, and send messages/media, all via a local Go bridge (whatsmeow) + SQLite store.

Communication Databases

Install Run on PlugMCP

1# Whatsapp Whatsmeow

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Server facts

Local

Transport: stdio
Last checked: 2026-10-27

Stars: 1
Tools: —
Uptime: —

Tools

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Whatsapp Whatsmeow?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Whatsapp Whatsmeow need an API key?

No required environment variable is listed on this record.

What transport does Whatsapp Whatsmeow use?

Whatsapp Whatsmeow runs locally over stdio.

When was Whatsapp Whatsmeow last checked?

Last checked 2026-10-27. MCP server that connects Opencode to your personal WhatsApp — read chat history, search contacts, and send messages/media, all via a local Go bridge (whatsmeow) + SQLite store.

From the publisher

Documentation

whatsapp-whatsmeow-mcp-server

An MCP (Model Context Protocol) server that connects Claude (or any MCP-compatible client) to your personal WhatsApp account.

Once linked, it lets an LLM read your chat history — text, images, videos, documents, and voice notes — look up contacts, and send messages or media to individuals and groups. It talks to WhatsApp through the whatsmeow library over the WhatsApp Web multi-device API, and everything is cached in a local SQLite database. Nothing leaves your machine unless a tool call explicitly pulls it in for the LLM.

Prerequisites

Go
Python 3.6+
Claude Desktop (or Cursor / Opencode)
uv — curl -LsSf https://astral.sh/uv/install.sh | sh
FFmpeg (optional) — only required if you want audio files auto-converted to .ogg Opus so they show up as playable voice notes. Without it, audio can still be sent as a plain file via send_file.

Setup

Clone the repo

git clone https://github.com/VIREN2779/whatsapp-whatsmeow-mcp-server.git
cd whatsapp-whatsmeow-mcp-server

Start the Go bridge
```
cd whatsapp-bridge
go run main.go
```
On first run it'll show a QR code — scan it from WhatsApp on your phone to link the device. Expect to re-scan roughly every 20 days.
Point your MCP client at the Python server

Fill in your own paths and drop this into the client's config:
```
{
  "mcpServers": {
    "whatsapp": {
      "command": "{{PATH_TO_UV}}",
      "args": [
        "--directory",
        "{{PATH_TO_REPO}}/whatsapp-mcp/whatsapp-mcp-server",
        "run",
        "main.py"
      ]
    }
  }
}
```
- {{PATH_TO_UV}} → output of which uv
- {{PATH_TO_REPO}} → output of pwd from inside the cloned repo
Config file locations by client:

Client Path
Claude Desktop ~/Library/Application Support/Claude/claude_desktop_config.json
Opencode C:\Users\sp\.config\opencode\opencode.json
Cursor ~/.cursor/mcp.json