# WhatsApp MCP (community)
> A community-maintained local MCP server that links a personal WhatsApp account, stores message history in a local SQLite database, and exposes contact, message, chat, media, and message-sending tools.
Canonical: https://www.mcpfolio.com/servers/whatsapp-mcp-lharries
Last updated: 2026-10-28
## Catalog record

- Publisher: Luke Harries / lharries (community; not affiliated with WhatsApp or Meta)
- Categories: database, search, communication

## Website

https://www.whatsapp.com/

## Repository

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

## Transports

stdio

## Authentication

Link a personal WhatsApp account by scanning the bridge's QR code with WhatsApp on the phone. The README says periodic re-authentication may be required, approximately every 20 days.

## Tools

- **search_contacts**: Search contacts by name or phone number.
- **list_messages**: Retrieve messages with filters and context.
- **list_chats**: List chats with metadata.
- **get_chat**: Get information about a chat.
- **get_direct_chat_by_contact**: Find a direct chat by contact.
- **get_contact_chats**: Find chats involving a contact.
- **get_last_interaction**: Get the most recent message with a contact.
- **get_message_context**: Retrieve surrounding context for a message.
- **send_message**: Send a message to an individual or group.
- **send_file**: Send an image, video, raw audio, or document.
- **send_audio_message**: Send an audio file as a playable voice message; requires OGG Opus or FFmpeg.
- **download_media**: Download media and return its local file path.

## Sources

- [Community maintainer repository README](https://github.com/lharries/whatsapp-mcp)
- [Official WhatsApp product site and logo asset](https://www.whatsapp.com/)
- [maintainer_or_vendor_tool_reference](https://github.com/lharries/whatsapp-mcp)

## Setup

Use the interactive setup panel on [the detail page](https://www.mcpfolio.com/servers/whatsapp-mcp-lharries) to view instructions for each supported client.