Whatsapp Claude Plugin MCP Server

Drive your Claude Code session from WhatsApp — your personal number, no bots, no API keys.

Local serverstdio

What is the Whatsapp Claude Plugin MCP server?

Whatsapp Claude Plugin MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. Drive your Claude Code session from WhatsApp — your personal number, no bots, no API keys.

What you get

  • Bidirectional messaging. — Send and receive from the session; long replies are chunked to WhatsApp's limits or sent as a document attachment past a configurable threshold
  • @-mentions. — reply can tag people so they actually get notified — ids are accepted as phone, LID, or full JID, and mentions attach only to the chunk that names them
  • Full media support. — Photos, voice notes, video, documents, and stickers, in both directions
  • Voice transcription. — Incoming voice notes are transcribed locally via mlx-whisper (see setup); without the script they arrive as plain attachments
  • Access control. — Pairing codes, allowlists, and per-group policies gate every inbound message — strangers never reach your session. Managed via /whatsapp-claude-channel:access
  • Per-group personalities. — Each group gets its own config.md with a custom personality and conversation memory

What the assistant can call

Once Whatsapp Claude Plugin is connected, these are the calls the assistant has available:

  • Per — group personalities.** Each group gets its own config.md with a custom personality and conversation memory
  • Self — diagnosis.** /whatsapp-claude-channel:doctor checks the server process, device link, singleton lock, and config, then walks you through the fixes —
  • Issue — Solution

Setting it up

mlx-whisper on PyPI is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Choosing this one

Among the team communication options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Whatsapp Claude Plugin's toolset — Per, Self, Issue — is a fair guide to whether it matches your workflow. It is maintained by rich627; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the whatsapp claude plugin mcp server does with a few real requests.

Available tools

ToolWhat it does
Pergroup personalities.** Each group gets its own config.md with a custom personality and conversation memory.
Selfdiagnosis.** /whatsapp-claude-channel:doctor checks the server process, device link, singleton lock, and config, then walks you through the fixes — no more guessing why replies stopped.
IssueSolution

How to install the Whatsapp Claude Plugin MCP server

{
  "mcpServers": {
    "whatsapp-claude-plugin": {
      "command": "uvx",
      "args": ["mlx-whisper"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Example prompts to try

  • Use Whatsapp Claude Plugin to Per.
  • Use Whatsapp Claude Plugin to Self.
  • Use Whatsapp Claude Plugin to Issue.

Frequently asked questions

It connects Whatsapp Claude Plugin to MCP-compatible AI assistants such as Claude and Cursor, exposing 3 tools (Per, Self, Issue) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Whatsapp Claude Plugin directly.