lharries/whatsapp-mcp

3.8

If you are the rightful owner of whatsapp-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This is a Model Context Protocol (MCP) server for WhatsApp, allowing users to interact with their WhatsApp messages and contacts through an LLM like Claude.

Tools

Functions exposed to the LLM to take actions

search_contacts

Search for contacts by name or phone number

list_messages

Retrieve messages with optional filters and context

list_chats

List available chats and their metadata

get_chat

Get information for specific chats

get_direct_chat_by_contact

Find direct chats with specific contacts

get_contact_chats

List all chats involving a specific contact

get_last_interaction

Get the latest news with contacts

get_message_context

Retrieve the context of a specific message

send_message

Send WhatsApp messages to the specified phone number or group JID

send_file

Send files (pictures, videos, original audio, document) to the specified recipient

send_audio_message

Send audio files as WhatsApp voice messages (requires the file in .ogg opus format or install ffmpeg)

download_media

Download media from WhatsApp messages and get local file path

Prompts

Interactive templates invoked by user choice

No prompts

Resources

Contextual data attached and managed by the client

No resources

Author

lharries

Claim Ownership

Verify you have write access to the repository

Version

v0.0.1

Repository

https://github.com/lharries/whatsapp-mcp

Homepage

https://x.com/LukeHarries_/status/1905986562388635913

GitHub Stars

4,713

License

MIT License

Last publish date

2025-04-06

Last update date

2025-08-19

Server configs

in claude desktop

{
  "mcpServers": {
    "whatsapp": {
      "command": "{{PATH_TO_UV}}",
      "args": [
        "--directory",
        "{{PATH_TO_SRC}}/whatsapp-mcp/whatsapp-mcp-server",
        "run",
        "main.py"
      ]
    }
  }
}

in cursor

{
  "mcpServers": {
    "whatsapp": {
      "command": "{{PATH_TO_UV}}",
      "args": [
        "--directory",
        "{{PATH_TO_SRC}}/whatsapp-mcp/whatsapp-mcp-server",
        "run",
        "main.py"
      ]
    }
  }
}

Top Comments

Related MCP Servers

View all communication servers →

mcp-hfspace

4.5

by evalstate

mcp-hfspace MCP Server connects to Hugging Face Spaces with minimal setup, providing Image Generation capabilities to Claude Desktop.

ai_chatbot

graphlit-mcp-server

4.4

by graphlit

The Model Context Protocol (MCP) Server for the Graphlit Platform facilitates integration between MCP clients and the Graphlit service, enabling seamless ingestion, search, and retrieval of knowledge across various platforms.

knowledge_and_memory

osp_marketing_tools

4.4

by open-strategy-partners

A comprehensive suite of tools for technical marketing content creation, optimization, and product positioning based on Open Strategy Partners' proven methodologies.

lharries/whatsapp-mcp

Tools

search_contacts

list_messages

list_chats

get_chat

get_direct_chat_by_contact

get_contact_chats

get_last_interaction

get_message_context

send_message

send_file

send_audio_message

download_media

Prompts

No prompts

Resources

No resources

Related MCP Servers

mcp-hfspace

graphlit-mcp-server

osp_marketing_tools

discord-mcp

Time

mcp-discord

mcp-hotnews-server

mcp-linkedin

reddit-mcp

gistpad-mcp

python-mcp-server-client

interactive-mcp

mcp-server-asana

algorand-mcp

backlog-mcp-server

telegram-bot-mcp-server

tiktok-mcp

Aspire.MCP.Sample

Inbox Zero AI

Gmail-MCP-Server

laravel-mcp-sdk

LikeC4

line-bot-mcp-server

gitlab-mcp

mcp-send-email

mcp-gsuite

monday.com MCP Server