wappmcp

Overview

wappmcp is a WhatsApp Web CLI and stdio MCP server that exposes WhatsApp functionality through the Model Context Protocol. It allows MCP-compatible clients to read WhatsApp data, send and manage messages, and subscribe to incoming WhatsApp events. Built on whatsapp-web.js, commander, and @modelcontextprotocol/sdk, it provides both read-only tools for accessing chats, contacts, and messages, as well as mutating tools for sending, replying, reacting, editing, and deleting messages.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• whatsapp_get_me

  Get information about the current WhatsApp account

  Try:Get my WhatsApp account informationTry:Show my WhatsApp profile details
• whatsapp_list_chats

  List all WhatsApp chats

  Try:Show me all my WhatsApp chatsTry:List all conversations
• whatsapp_get_chat

  Get details of a specific WhatsApp chat

  Try:Get details of my family group chatTry:Show information about the work chat
• whatsapp_get_chat_messages

  Get messages from a specific WhatsApp chat

  Try:Show recent messages in the work chatTry:Get messages from the family group
• whatsapp_send_message

  Send a message to a WhatsApp chat

  Try:Send 'Hello!' to JohnTry:Message the group about the meeting
• whatsapp_reply_to_message

  Reply to a specific WhatsApp message

  Try:Reply to the last message with 'Thanks!'Try:Respond to the message about dinner
• whatsapp_react_to_message

  React to a specific WhatsApp message

  Try:React to that message with a thumbs upTry:Add a heart reaction to the last message
• whatsapp_edit_message

  Edit a previously sent WhatsApp message

  Try:Edit my last message to fix the typoTry:Change the message to 'I'll be there in 10 minutes'
• whatsapp_delete_message

  Delete a WhatsApp message

  Try:Delete the message I sent by mistakeTry:Remove that message about the surprise party
• whatsapp_forward_message

  Forward a WhatsApp message to another chat

  Try:Forward that funny meme to the groupTry:Share the message with John
• whatsapp_list_contacts

  List all WhatsApp contacts

  Try:Show me all my WhatsApp contactsTry:List everyone in my address book
• whatsapp_send_typing

  Send a typing indicator to a WhatsApp chat

  Try:Let John know I'm typingTry:Show typing status in the family group

Comparable tools

Installation

npm install -g wappmcp

npx wappmcp configure

npx wappmcp mcp

npx wappmcp mcp --channels

{
  "mcpServers": {
    "whatsapp": {
      "command": "npx",
      "args": ["wappmcp", "mcp"]
    }
  }
}

FAQ

Does this work with multi-device WhatsApp sessions?

Yes, but some device metadata may be unavailable in multi-device sessions.

How do I manage allowed users and chats?

Run 'npx wappmcp configure' to set up an interactive configuration interface where you can manage allowlists for users and chats.

Compare wappmcp with