Skip to content
MCP server

Nodium WhatsApp

Let an agent read WhatsApp conversations and contacts through the Nodium API

Install
Platforms
API, whatsapp
Runs
Remotely
Version
1.0.0
Listing updated
5 days ago

Similar MCP servers

About Nodium WhatsApp

Nodium WhatsApp is an MCP server for communication. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://nodium.io/api/v1/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "whatsapp": {
      "url": "https://nodium.io/api/v1/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to Grok Bot desktop app → Connect apps → Add a custom connector

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.

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (21)

Taken from the project documentation; the running server may differ.

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.

What it does

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

More servers for the same service

Nodium WhatsApp 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.

How AIPoweredBot checks servers