Whatsapp MCP Server

@gfb-47

Basic information

About Whatsapp MCP Server

No overview available yet

Whatsapp MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "whatsapp": {
      "command": "node",
      "args": [
        "/Users/gabrielbeckman/whatsapp-mcp/whatsapp-mcp-server/dist/index.js"
      ]
    }
  }
}

Whatsapp MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Whatsapp?

The WhatsApp MCP server is a Node.js application that enables programmatic interaction with the WhatsApp desktop application on macOS using AppleScript automation. It provides a simple interface for sending messages and checking WhatsApp status without requiring direct UI interaction. It is built for developers who want to integrate WhatsApp messaging into AI workflows.

How to use Whatsapp?

Install the server by cloning the repository and running npm install, then start it with node index.js. Configure it in Claude Desktop by adding a claude_desktop_config.json entry with the command and path to index.js. Once integrated, invoke tools such as send-whatsapp-message or check-whatsapp-status via an MCP client.

Features of Whatsapp

Send text messages to specific WhatsApp contacts.
Check if the WhatsApp desktop application is running.
List recent contacts (limited due to WhatsApp privacy).
Uses AppleScript for macOS automation.
Comprehensive error logging to file and console.
Implements MCP stdio transport for tool communication.

Use cases of Whatsapp

Let an AI assistant send a WhatsApp message on your behalf.
Verify WhatsApp is running before attempting to send messages.
Automate routine WhatsApp messages from a script or chatbot.
Integrate WhatsApp messaging into a larger MCP‑powered toolchain.

Frequently asked questions

What operating system does it require?

It requires macOS because it relies on AppleScript to automate the WhatsApp desktop application.

What are the runtime requirements?

You need Node.js v14.0.0 or higher, the WhatsApp desktop application installed, and an internet connection.

How does it handle WhatsApp's privacy protections?

The `list‑recent‑contacts` tool informs users about WhatsApp’s privacy limitations and requires exact contact names for messaging.

Where are logs stored?

Logs are written to `~/Library/Logs/whatsapp-mcp/` in addition to console output.

What transport does it use?

It uses stdio transport as part of the Model Context Protocol (MCP).

Comments

More Communication MCP servers

SocialFaktory

Run a brand's social media from your agent: write posts in the brand's voice, generate short videos, schedule and publish to TikTok, Instagram, YouTube, X, LinkedIn, Facebook and Pinterest, and read the metrics back. 21

atbridge.ai

atbridge-ai

Local MCP server for Thunderbird. Gives Claude Desktop, Cursor, or any MCP client read/write access to multiple mailboxes, calendars, contacts, notes & tasks (Gmail, Outlook, IMAP) — all on your machine.

RelayLink

RelayLink lets your AI assistant send briefings to other people's AI assistants. Draft a package from your current conversation, attach files, approve the note, and the recipient's AI gets the full context: decisions, op

Soprano Connect MCP Server

soprano-mcp

Soprano Connect MCP Server enables you to build AI agents that can communicate, engage customers, and manage communications workflows through the Soprano Connect platform using the Model Context Protocol (MCP).

SendRaven

CommonNinja

SendRaven is email infrastructure for AI agents. Send, read replies as threads, run campaigns and automations, with limits on the API key.