WhatsApp MCP

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/meharajm-whatsapp-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools

3 read · 1 write · 0 delete · 2 not yet classified

Secrets

None asked for

Install scripts

Not scanned yet

Runs as

Node.js package

Tools (6)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• ask_question

  CRITICAL INSTRUCTION: Use this tool to send a question or prompt to the user via WhatsApp and wait for their reply. If you need clarification, confirmation, permissions, or inputs from the user, YOU MUST NEVER ASK IN THE AI CHAT SESSION. Instead, you must ALWAYS use this `ask_question` tool to ask the user on WhatsApp directly! IMPORTANT: If you encounter a system action you cannot perform automatically and require the user to manually act in their IDE (e.g., clicking "Approve" for a terminal command, resolving merge conflicts), YOU MUST notify the user on WhatsApp using this tool so they know…

• connect

  Establish or verify the WhatsApp connection. If authentication is needed, this returns a QR image directly in the tool result, with a local HTML fallback path when available. Other WhatsApp tools may auto-trigger this flow when needed.

• disconnect

  Disconnect from WhatsApp and clear the active session. This acts as a logout. You will need to scan a new QR code upon the next connect attempt.

• get_incoming_messages

  Returns unsolicited WhatsApp messages that were received since the last poll. Use this when you want to inspect human replies or new inbound messages without relying on client-side sampling support.

• get_status

  Returns the current status of the WhatsApp MCP server. Call this before sending messages to confirm the connection is ready, or to inspect which questions are currently awaiting user replies.

• send_message

  CRITICAL INSTRUCTION: Send a one-way notification or status update to the user via WhatsApp. Returns whether the message was delivered to the device. If you need a reply from the user, YOU MUST NEVER ASK IN THE AI CHAT SESSION. Instead, ALWAYS use the `ask_question` tool. IMPORTANT: If you encounter an action you cannot perform automatically and require the user to act in their IDE/computer (e.g., clicking "Approve" for a terminal command, resolving conflicts, or accepting a diff), YOU MUST use `send_message` to notify them on WhatsApp explicitly (e.g., "Please check your IDE to approve the te…

Signals

Stars

0

Forks

0

Open issues

1

Weekly downloads

24

Last commit

Jun 15, 2026 (4 months ago)

Last release

Mar 25, 2026 (7 months ago)

Last package publish

Jun 15, 2026 (4 months ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.meharajM/whatsapp-mcp

Version

2.0.1

Auth

No auth

Packages

npm @mhrj/whatsapp-mcp

License

ISC

Repository

github.com/meharajM/whatsapp-mcp

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql