WhatsApp Desktop

by gfb-47

3 stars

Not rated

GitHub

About

Enables interaction with WhatsApp desktop on macOS through AppleScript automation for sending messages, checking status, and navigating the interface with keyboard shortcuts.

Details

Author: gfb-47
Repository: gfb-47/whatsapp-mcp-server
GitHub stars: 3
Categories: Productivity, Design, Developer Tools, AI, Frontend, Communication, Infrastructure
Tags: #integration

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name WhatsApp Desktop

Command (node, npx, python, etc.) node
Arguments
- Argument 1 path/to/your/index.js
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "whatsapp desktop": {
            "cwd": "string (optional)",
            "env": {},
            "args": [
                "path/to/your/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "whatsapp desktop": {
            "cwd": "string (optional)",
            "env": {},
            "args": [
                "/c",
                "node",
                "path/to/your/index.js"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "whatsapp desktop": {
            "cwd": "string (optional)",
            "env": {},
            "args": [
                "path/to/your/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "whatsapp desktop": {
            "cwd": "string (optional)",
            "env": {},
            "args": [
                "path/to/your/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "whatsapp desktop": {
            "cwd": "string (optional)",
            "env": {},
            "args": [
                "/c",
                "node",
                "path/to/your/index.js"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "whatsapp desktop": {
            "cwd": "string (optional)",
            "env": {},
            "args": [
                "path/to/your/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "whatsapp desktop": {
            "cwd": "string (optional)",
            "env": {},
            "args": [
                "path/to/your/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "whatsapp desktop": {
            "cwd": "string (optional)",
            "env": {},
            "args": [
                "/c",
                "node",
                "path/to/your/index.js"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "whatsapp desktop": {
            "cwd": "string (optional)",
            "env": {},
            "args": [
                "path/to/your/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "whatsapp desktop": {
            "cwd": "string (optional)",
            "env": {},
            "args": [
                "path/to/your/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "whatsapp desktop": {
            "cwd": "string (optional)",
            "env": {},
            "args": [
                "/c",
                "node",
                "path/to/your/index.js"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "whatsapp desktop": {
            "cwd": "string (optional)",
            "env": {},
            "args": [
                "path/to/your/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "whatsapp desktop": {
            "cwd": "string (optional)",
            "env": {},
            "args": [
                "path/to/your/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "whatsapp desktop": {
            "cwd": "string (optional)",
            "env": {},
            "args": [
                "/c",
                "node",
                "path/to/your/index.js"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "whatsapp desktop": {
            "cwd": "string (optional)",
            "env": {},
            "args": [
                "path/to/your/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

From the repository

npm install
```

`send-whatsapp-message`

Sends a message to a specified WhatsApp contact. Parameters: contactName (string) - Full name of the contact as it appears in WhatsApp, message (string) - Content of the message to send.

`check-whatsapp-status`

Checks if the WhatsApp application is currently running. No parameters required.

`list-recent-contacts`

Provides information about WhatsApp's privacy limitations for contact listing. No parameters required.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "whatsapp desktop": {
            "cwd": "string (optional)",
            "env": {},
            "args": [
                "path/to/your/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Linux

{
    "cwd": "string (optional)",
    "env": [],
    "args": [
        "path/to/your/index.js"
    ],
    "shell": false,
    "command": "node"
}

Macos

{
    "cwd": "string (optional)",
    "env": [],
    "args": [
        "path/to/your/index.js"
    ],
    "shell": false,
    "command": "node"
}

Windows

{
    "cwd": "string (optional)",
    "env": [],
    "args": [
        "/c",
        "node",
        "path/to/your/index.js"
    ],
    "shell": false,
    "command": "cmd"
}

WhatsApp MCP Server

Overview

The WhatsApp MCP (Model Context Protocol) 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 interaction with the WhatsApp UI.

Features

1. Send Messages to Contacts

Send text messages to specific contacts in your WhatsApp contact list: - Messages are delivered through your connected WhatsApp desktop application - Supports proper formatting of messages including line breaks - Uses AppleScript to automate the WhatsApp desktop interface

2. Check WhatsApp Status (WIP)

Verify if the WhatsApp application is currently running: - Returns the current running status of WhatsApp - Helps prevent errors when attempting to send messages

3. List Recent Contacts (WIP)

Due to WhatsApp's privacy protections, this feature provides limited functionality: - Informs users about WhatsApp's privacy limitations - Requires exact contact names for messaging

Technical Implementation

Built With

- @modelcontextprotocol/sdk - MCP server and stdio transport - Zod - Schema validation - Node.js built-in modules (child_process, util, fs) - AppleScript for macOS automation

Architecture

- Uses the Model Context Protocol (MCP) for standardized tool communication - Employs stdio transport for communication - Executes AppleScript commands to interact with the WhatsApp desktop application - Implements comprehensive error logging for debugging

Requirements

- macOS operating system - WhatsApp desktop application installed - Node.js v14.0.0 or higher - Internet connection

Installation

# Clone the repository
git clone https://github.com/yourusername/whatsapp-mcp-server.git
Navigate to the project directory
cd whatsapp-mcp-server
Install dependencies
npm install

Usage

Starting the Server

node index.js

Integrating with Claude

To enable Claude to use the WhatsApp MCP server, follow these steps:

1. Set up your MCP server
- Install and configure the WhatsApp MCP server as described above
- Ensure the server is running properly on your local machine

2. Configure Claude Desktop with your MCP tools
- Modify your claude_desktop_config.json file to include the WhatsApp MCP tools
- This file is typically located in your Claude Desktop application configuration directory
- Add the following configuration to register your WhatsApp MCP tools:


{
  "mcpServers": [
    {
      "name": "whatsapp-mcp",
      "transport": {
        "command": "node",
        "args": ["path/to/your/index.js"]
      }
    }
  ]
}

3. Test the Integration
- Create a test conversation with Claude
- Ask Claude to send a WhatsApp message to a test contact
- Verify that the message is sent successfully through the WhatsApp desktop app

MCP Tools Available

1. send-whatsapp-message

Sends a message to a specified WhatsApp contact.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

send-whatsapp-message

check-whatsapp-status

list-recent-contacts

Claude Desktop / Cursor

Linux

Macos

Windows

WhatsApp MCP Server

Overview

Features

1. Send Messages to Contacts

2. Check WhatsApp Status (WIP)

3. List Recent Contacts (WIP)

Technical Implementation

Built With

Architecture

Requirements

Installation

Navigate to the project directory

Install dependencies

Usage

Starting the Server

Integrating with Claude

MCP Tools Available

1. send-whatsapp-message

Install

More like this

Time

Sentry

Github

Git

GitLab

Context 7

`send-whatsapp-message`

`check-whatsapp-status`

`list-recent-contacts`