# neuron-whatsapp

The neuron-whatsapp MCP server connects Claude Code to Neuron tools for managing bots and WhatsApp conversations. Configure bots, handle chats, and send messages through the API.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 152 installs
- Author: rsh
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/rsh/neuron
- Updated: 2026-06-28
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/neuron-whatsapp

## What it does

The server gives an agent tools to create and configure bots, attach knowledge bases, and view bot analytics. Conversation tools can fetch message history, hand a chat to a human, return it to the bot, or send a message. WhatsApp messages can include media.

Other tools cover Neuron accounts, organizations, and API keys. Sign-in can open a browser authorization page or use a token; the legacy email-and-password option exposes credentials to the AI. Bot API calls need a valid API key. A bot key cannot be retrieved again after creation, so save it when you create it.

## Requirements
- Remote server: `https://neuron-whatsapp.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http neuron https://neuron-whatsapp.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add neuron-whatsapp --url https://neuron-whatsapp.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "neuron-whatsapp": {
            "url": "https://neuron-whatsapp.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "neuron-whatsapp": {
            "type": "http",
            "url": "https://neuron-whatsapp.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http neuron-whatsapp https://neuron-whatsapp.run.tools
```

## When to use it
- create a bot and set its behavior
- attach a knowledge base to a bot
- hand a conversation to a human agent
- send WhatsApp messages with media
- retrieve a conversation's message history

## Example prompts
- Create a bot to answer incoming messages and attach a knowledge base.
- Hand this conversation to a human so the bot stops replying.
- Send a WhatsApp message with an image to this phone number.

## Similar
- [whatsapp-automation](https://affpapa.org/en/nevibecode/skills/whatsapp-automation.md) — skill · 6700 installs
- [integrate-whatsapp](https://affpapa.org/en/nevibecode/skills/integrate-whatsapp.md) — skill · 5400 installs
- [whatsapp-cloud-api](https://affpapa.org/en/nevibecode/skills/whatsapp-cloud-api.md) — skill · 711 installs
- [WhatsApp Business API by Wassenger](https://affpapa.org/en/nevibecode/mcp/whatsapp-business-api-by-wassenger.md) — MCP server · ★ 6 repo stars
- [twilio-whatsapp-manage-senders](https://affpapa.org/en/nevibecode/skills/twilio-whatsapp-manage-senders.md) — skill · 1 install
- [whatsapp](https://affpapa.org/en/nevibecode/skills/whatsapp.md) — skill · 373 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
