# Nodium WhatsApp

> Nodium WhatsApp is an MCP server for communication. Let an agent read WhatsApp conversations and contacts through the Nodium API. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API, whatsapp
- **Website:** https://nodium.io/en/docs/api/guide/mcp
- **Repository:** https://github.com/nodium-io/sdk
- **MCP Registry name:** io.github.Nodium-io/whatsapp
- **Categories:** [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-14

## About

Sending is off by default here. The send_message tool is listed and callable only when the server URL ends with ?send=true, so an agent that reads inbound messages from strangers cannot be tricked by a hidden instruction into replying. Broadcasts, templates, clients and connect links are deliberately not tools either, so a slipped-in instruction cannot message everyone or change the account.

The server is the Nodium API and nothing more: each tool calls the matching route with your key, so client isolation, quotas, rate limits and the request log apply as they do for your own code. Tools can take an optional tenant to act on a specific client. The docs advise giving each agent its own key, pinned to one client and with an expiry.

It covers channels, conversations and messages, contacts, templates and flows, broadcast previews, clients and a billing summary.

## Features

- **Opt-in sending:** send_message appears only when the URL ends with ?send=true.
- **Conversation access:** List and read conversations and messages and mark them read.
- **Contact upkeep:** List and fetch contacts and update them.
- **Broadcast preview:** See who a broadcast would reach without sending anything.
- **Channel diagnostics:** List and diagnose connected WhatsApp numbers.
- **Per-client scoping:** A key can be pinned to one client and given an expiry.

## Good for

- Summarise a WhatsApp inbox with an agent
- Keep contact records up to date from conversations
- Diagnose why a number is not working
- Check billing for each client account

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http whatsapp https://nodium.io/api/v1/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://nodium.io/api/v1/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "whatsapp": {
      "url": "https://nodium.io/api/v1/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "whatsapp": {
      "type": "http",
      "url": "https://nodium.io/api/v1/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "whatsapp": {
      "serverUrl": "https://nodium.io/api/v1/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://nodium.io/api/v1/mcp
```

Enter a Name (for example "Nodium WhatsApp"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "whatsapp": {
      "type": "http",
      "url": "https://nodium.io/api/v1/mcp"
    }
  }
}
```

## Tools

- `list_channels`: Lists numbers.
- `get_channel`: Gets one channel.
- `diagnose_channel`: Diagnoses a channel.
- `list_conversations`: Lists conversations.
- `get_conversation`: Gets one conversation.
- `list_messages`: Lists messages.
- `get_message`: Gets one message.
- `mark_read`: Marks messages read.
- `send_message`: Sends a message; only available with ?send=true.
- `list_contacts`: Lists contacts.
- `get_contact`: Gets one contact.
- `update_contact`: Updates a contact.
- `list_templates`: Lists templates.
- `get_template`: Gets one template.
- `list_flows`: Lists flows.
- `list_broadcasts`: Lists broadcasts.
- `get_broadcast`: Gets one broadcast.
- `preview_broadcast`: Shows who a broadcast would reach without sending.
- `list_clients`: Lists clients.
- `get_client`: Gets one client.
- `get_billing_summary`: Returns a billing summary.

## FAQ

### Can the agent send messages?

Only if you add ?send=true to the server URL.

### How is it authenticated?

With your Nodium API key.

### Can it send broadcasts?

No. Broadcast sending, templates and client changes are left to the API.

### How do I limit what an agent can reach?

Create a key pinned to one client and give it an expiry.

### How do I add Nodium WhatsApp to Claude Code?

Run this command in your terminal: claude mcp add --transport http whatsapp https://nodium.io/api/v1/mcp

### What are the best alternatives to Nodium WhatsApp?

The closest alternatives to Nodium WhatsApp are Whatsapp Tools, whatsapi.sh, Hellohop, Wazap and Turbo Notify: WhatsApp for AI agents.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Whatsapp Tools](https://ai-powered.com/mcp/whatsapp-tools): Whatsapp Tools is an open-source MCP server for communication.
- [whatsapi.sh](https://ai-powered.com/mcp/whatsapi-sh): whatsapi.sh is an MCP server for communication.
- [Hellohop](https://ai-powered.com/mcp/hellohop): Hellohop is a paid MCP server for communication.
- [Wazap](https://ai-powered.com/mcp/wazap): Wazap is an open-source MCP server for communication.
- [Turbo Notify: WhatsApp for AI agents](https://ai-powered.com/mcp/turbo-notify-whatsapp-for-ai-agents): Turbo Notify: WhatsApp for AI agents is an MCP server for communication.
- [Wagent](https://ai-powered.com/mcp/wagent): Wagent is an MCP server for communication.
- [Turbo Notify: WhatsApp for AI agents](https://ai-powered.com/mcp/turbo-notify-whatsapp-for-ai-agents-2): Turbo Notify: WhatsApp for AI agents is an MCP server for communication.
- [Wapliss WhatsApp](https://ai-powered.com/mcp/wapliss-whatsapp): Wapliss WhatsApp is a freemium MCP server for communication.

---
Source: https://ai-powered.com/mcp/nodium-whatsapp
