WhatsApp MCP Server logo

WhatsApp MCP Server

by gfb-47

The WhatsApp MCP server is a Node.js application that enables programmatic interaction with the WhatsApp desktop application on macOS. It provides a simple interface for sending messages and checking WhatsApp status without requiring direct interaction with the WhatsApp UI.

View on GitHub

Last updated: N/A

What is WhatsApp MCP Server?

The WhatsApp MCP Server is a Node.js application that uses AppleScript to automate the WhatsApp desktop application on macOS, providing a programmatic interface for sending messages and checking status.

How to use WhatsApp MCP Server?

To use the server, clone the repository, install dependencies with npm install, and start the server with node index.js. Then, configure Claude Desktop with the MCP server details. You can then use natural language prompts with Claude to send messages, check WhatsApp status, or get contact information.

Key features of WhatsApp MCP Server

  • Send Messages to Contacts

  • Check WhatsApp Status

  • List Recent Contacts (limited functionality)

  • Uses Model Context Protocol (MCP)

Use cases of WhatsApp MCP Server

  • Automating WhatsApp messaging

  • Integrating WhatsApp with AI assistants like Claude

  • Programmatically checking WhatsApp status

  • Sending automated notifications via WhatsApp

FAQ from WhatsApp MCP Server

What operating systems does this server support?

This server only supports macOS due to its dependency on AppleScript.

Does this server require the WhatsApp desktop application?

Yes, the WhatsApp desktop application must be installed on your macOS system.

Can I access the full contact list using this server?

Due to WhatsApp's privacy protections, access to the contact list is limited. You need to know the exact contact name for messaging.

Is this project affiliated with WhatsApp or Meta?

No, this project is not affiliated with WhatsApp Inc. or Meta Platforms, Inc.

What are the security considerations?

The server interacts with your personal WhatsApp account. Messages are sent from your account and appear as sent by you. Use in trusted environments only.