BrOrlandi

Whatsapp MCP — AI skill for Claude Code

AI community

Connect your WhatsApp to your AI agents over MCP — a self-hosted Go gateway with a control panel, message index and one-command install.

How to install Whatsapp MCP

This entry records only its repository, not the path inside it, so there is no exact command to give. Open BrOrlandi/whatsapp-mcp and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Whatsapp MCP does

Connect your WhatsApp to your AI agents over MCP — a self-hosted Go gateway with a control panel, message index and one-command install.

Alternatives in AI

  • Axonhub — ⚡️ Open-source AI Gateway — Use any SDK to call 100+ LLMs 3.2k ★
  • Agentrq — AgentRQ: Human-in-loop realtime conversational task manager for AI Agents 1.1k ★
  • Agenvoy — Self-hosted AI agent harness in a single Go binary — writes, sandbox-tests and repairs its own tools, and lets 474 ★

README

WhatsApp MCP

Connect your WhatsApp to your AI agents over MCP.
A self-hosted Go gateway that puts a WhatsApp account behind one authenticated MCP endpoint.

License: PolyForm Noncommercial 1.0.0 Go Self-hosted


Ask Claude to read a conversation, search a year of messages, send a file, run a poll — against your own WhatsApp, on your own server. Evolution Go, RabbitMQ and PostgreSQL run behind it; the MCP client needs none of them.

A client needs exactly one thing: an API key. The key identifies the account and the WhatsApp instance it is authorised for, so there is no user, no password and no instance name to configure.

{
  "mcpServers": {
    "whatsapp": {
      "type": "http",
      "url": "https://whatsapp.example.com/mcp",
      "headers": { "Authorization": "Bearer wamcp-…" }
    }
  }
}

Keys are issued and revoked in the control panel, which prints that block already filled in. Keep the key in the client's credential store, never in a prompt or a versioned file.

What it can do

21 tools across four groups — read, send, act, operate:

  • Read the index: list conversations, read a period, full-text search, request history older than what has been ingested.
  • Send: text, media from a URL, a location, a contact card, a poll — each reporting whether WhatsApp actually delivered it, not just whether the API accepted it.
  • Act on a message: delete (two-step, because revoking reaches other people's phones), edit, react, archive/pin/mute a conversation.
  • Ask about the account: c