Communication · Developer Tools

MCP Whatsapp Web logo

MCP Whatsapp Web

mario-andreschak/mcp-whatsapp-web

Automation of Whatsapp Messages without Meta (Business-)API is against WhatsApp' Terms of Service! You take full responsibility for everything you do with this MCP-Server. It is possible that your account will be flagged/restricted.

Install

npx mcp-whatsapp-web

Client configuration

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

Environment variables

WHATSAPP_BACKENDBAILEYS_SESSION_DIRPUPPETEER_SKIP_DOWNLOAD
Category
Communication, Developer Tools
License
MIT
Updated
Oct 6, 2026

Features

  • TypeScript Implementation: Fully typed codebase for better developer experience and code reliability

  • Selectable WhatsApp Backend: Uses whatsapp-web.js by default, with an optional Baileys backend that runs without a browser

  • MCP Server: Implements the Model Context Protocol for seamless integration with AI assistants

  • Media Support: Send and receive images, videos, documents, and audio messages

  • Multiple Transport Options: Supports stdio and Streamable HTTP transports — even both at once from a single process (start with stdio and set MCP_HTTP_PORT to additionally expose…

  • Flexible Authentication: QR code (as an MCP image tool), pairing code (request_pairing_code tool, or automatically printed to stderr at startup via WHATSAPP_PAIRING_PHONE_NUMBER), and an optional…

Tools (13)

  • get_qr_code

    Get the QR code for WhatsApp Web authentication

  • check_auth_status

    Check if you're currently authenticated with WhatsApp

  • logout

    Log out from WhatsApp and clear the current session

  • search_contacts

    Search for contacts by name or phone number

  • get_contact

    Get information about a specific contact

  • get_chat

    Get information about a specific chat

  • get_direct_chat_by_contact

    Find a direct chat with a specific contact

  • list_messages

    Retrieve messages with optional filters

  • get_message

    Get a specific message by ID

  • send_message

    Send a text message to a chat

  • send_file

    Send a file (image, video, document) to a chat

  • send_audio_message

    Send an audio message (voice note)

  • download_media

    Download media from a message

Details on this page are taken from the project's README. Open README

Supported clients

Clients mentioned in this server's README:

View all
Claude Desktop logo

Claude Desktop

Desktop · Freemium · Proprietary

Anthropic's official Claude AI desktop application. Supports MCP servers to extend functionality.

WindowsMacOS
Cursor logo

Cursor

Desktop · Freemium · Proprietary

The first agentic IDE. The Cursor editor truly merges how developers and AI work together, delivering a magical coding experience.

WindowsMacOSLinux

Related MCP servers

More servers
Inbox Zero AI MCP logo

Inbox Zero AI MCP

elie222/inbox-zero

7.1k

To help you spend less time in your inbox, so you can focus on what matters most.

Communication
whatsapp logo

whatsapp

lharries/whatsapp-mcp

3.6k

This is a Model Context Protocol (MCP) server for WhatsApp.

Communication
Apple MCP Server logo

Apple MCP Server

Dhravya/apple-mcp

1.5k

Apple MCP toolset is a collection of Apple native tools based on the MCP protocol, providing integration services for Messages, Notes, Contacts, Mail, Reminders, Calendar and other Apple ecosystem features.

Communication
supergateway logo

supergateway

supercorp-ai/supergateway

1.1k

Supergateway runs MCP stdio-based servers over SSE (Server-Sent Events) or WebSockets (WS) with one command. This is useful for remote access, debugging, or connecting to clients when your MCP server only supports stdio.

Communication
Line Bot MCP Server logo

Line Bot MCP Server

line/line-bot-mcp-server

338

Model Context Protocol (MCP) server implementation that integrates the LINE Messaging API to connect an AI Agent to the LINE Official Account.

Communication
MCP Send Email logo

MCP Send Email

resend/mcp-send-email

325

Connect your AI agent to the Resend platform. Send and receive emails, manage contacts, broadcasts, domains, and more, directly from any MCP client like Claude, Cursor, or Claude Code.

Communication