Golang WhatsApp

MCP server for Go-based WhatsApp integration enabling AI agents to send messages, contacts, links, and locations via SSE endpoints.

GitHub Stars

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "samihalawa-whatsapp-go-mcp": {
      "command": "go",
      "args": [
        "run",
        ".",
        "mcp"
      ],
      "env": {
        "APP_OS": "Chrome",
        "DB_URI": "file:storages/whatsapp.db?_foreign_keys=on",
        "APP_PORT": "8080",
        "APP_DEBUG": "true",
        "APP_BASE_PATH": "/gowa",
        "APP_BASIC_AUTH": "user:pass",
        "WHATSAPP_WEBHOOK": "https://webhook.site/xxx",
        "WHATSAPP_AUTO_REPLY": "Auto reply message",
        "WHATSAPP_CHAT_STORAGE": "true",
        "WHATSAPP_AUTO_MARK_READ": "true",
        "WHATSAPP_WEBHOOK_SECRET": "super-secret-key",
        "WHATSAPP_ACCOUNT_VALIDATION": "false"
      }
    }
  }
}

You can run an MCP (Model Context Protocol) server for Golang WhatsApp to enable AI agents and tools to interact with WhatsApp through a standardized protocol. It exposes a server you can connect to via MCP, supports SSE transport, and provides specific tools to send messages, contacts, links, and locations. Start the MCP server and then connect your MCP client to control WhatsApp programmatically.

How to use

To use the MCP server, first start the MCP instance of the WhatsApp service. The MCP server will listen on the default host and port and provide endpoints for SSE and message handling. By default, it starts at http://localhost:8080 for MCP connections and http://localhost:3000 for the REST API front. Use an MCP-enabled AI tool or client to connect to the SSE endpoint to receive events and issue commands.

How to install

Prerequisites you need before installing and running the MCP server: a Go toolchain (Go 1.24.0 or higher) and FFmpeg for media processing.

Step-by-step commands to set up and run the MCP server locally as a Go stdio server:

Clone the repository that contains the WhatsApp MCP server code.
Change into the source directory.
Run the MCP server using Go.
Access the MCP server and test the endpoints.

Additional configuration and usage notes

{
  "mcpServers": {
    "whatsapp": {
      "url": "http://localhost:8080/sse"
    }
  }
}

Available tools

whatsapp_send_text

Send text messages via the MCP server using the whatsapp_send_text tool.

whatsapp_send_contact

Send contact cards via the MCP server using the whatsapp_send_contact tool.

whatsapp_send_link

Send links with captions via the MCP server using the whatsapp_send_link tool.

whatsapp_send_location

Send location coordinates via the MCP server using the whatsapp_send_location tool.

Built by

VeilStrat

AI signals for GTM teams