Communication · AI Chatbot

whatsapp logo

whatsapp

lharries/whatsapp-mcp

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

Install

Client configuration

{
  "mcpServers": {
    "whatsapp": {
      "command": "{{PATH_TO_UV}}",
      "args": [
        "--directory",
        "<value>",
        "run",
        "main.py"
      ]
    }
  }
}
GitHub stars
3,561
Author
@lharries
Category
Communication, AI Chatbot
Updated
Oct 6, 2026

About whatsapp

With this you can search and read your personal Whatsapp messages (including images, videos, documents, and audio messages), search your contacts and send messages to either individuals or groups. You can also send media files including images, videos, documents, and audio messages.

Features

  • Images, Videos, Documents: Use the send_file tool to share any supported media type.

  • Voice Messages: Use the send_audio_message tool to send audio files as playable WhatsApp voice messages.

Tools (10)

  • search_contacts

    Search for contacts by name or phone number

  • list_messages

    Retrieve messages with optional filters and context

  • get_chat

    Get information about a specific chat

  • get_direct_chat_by_contact

    Find a direct chat with a specific contact

  • get_last_interaction

    Get the most recent message with a contact

  • get_message_context

    Retrieve context around a specific message

  • send_message

    Send a WhatsApp message to a specified phone number or group JID

  • send_file

    Send a file (image, video, raw audio, document) to a specified recipient

  • send_audio_message

    Send an audio file as a WhatsApp voice message (requires the file to be an.ogg opus file or ffmpeg must be installed)

  • download_media

    Download media from a WhatsApp message and get the local file path

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
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
MCP Gsuite logo

MCP Gsuite

MarkusPfundstein/mcp-gsuite

318

An MCP server project providing interaction with Google products such as Gmail and Calendar, supporting multi-account management, email queries and operations, and calendar event management.

Communication