mcp-registry/whatsapp-mcp

    ==================
      
       /// MCP ///
      /// WHA ///
        
    ==================
        
    [server:online]
    [protocol:ready]

whatsapp-mcp

by lharries

Model-Context-Protocol (MCP) server that lets Claude / Cursor read, search and send WhatsApp messages (text & media) through your personal account.

4.6k
658
Specialized
GitHubWebsiteTwitter

Installation

1. Prerequisites
• Go 1.22+ installed and configured (GOPATH, GOBIN in your PATH)
• A WhatsApp Cloud/API token with permission to send/receive messages
• (Optional) A PostgreSQL or Redis instance if you intend to persist sessions
2. Fetch the source & build
# grab the latest tagged release $ git clone https://github.com/lharries/whatsapp-mcp.git $ cd whatsapp-mcp # build the server $ go build -o whatsapp-mcp ./cmd/server
OR install directly with go install
$ go install github.com/lharries/whatsapp-mcp/cmd/server@latest
The binary will be placed in $GOBIN (usually ~/go/bin).
3. Configure environment
Create a .env or export the following variables before running:
WHATSAPP_TOKEN=<your-cloud-api-token> WHATSAPP_PHONE_ID=<business-phone-number-id> MCP_PORT=8080 # port the MCP server will listen on MCP_DB_DSN=<optional-db-dsn> # e.g. postgres://user:pass@localhost/db
4. Run the server
$ ./whatsapp-mcp # or whatsapp-mcp.exe on Windows # or specify a custom config file: $ ./whatsapp-mcp --config ./config.yaml
5. Reverse-proxy (production)
Behind Nginx / Caddy enable HTTPS and forward to localhost:8080.
6. Docker (quick start)
$ docker run -d \ -e WHATSAPP_TOKEN=$WHATSAPP_TOKEN \ -e WHATSAPP_PHONE_ID=$WHATSAPP_PHONE_ID \ -p 8080:8080 \ ghcr.io/lharries/whatsapp-mcp:latest
After the server is up, point your MCP client or agents at http://<host>:8080/api.

Documentation

License: MIT License
Updated 7/30/2025

Table of Contents