What is WhatsApp MCP Server?

It is a community MCP server that connects an AI client to a personal WhatsApp account through a local bridge and MCP tools.

How does it connect to WhatsApp?

The README says it uses the WhatsApp Web multidevice API through the whatsmeow library and prompts the user to authenticate with a QR code.

Does it store messages locally?

Yes. The README states messages are stored locally in a SQLite database and sent to an LLM only when the agent accesses them through tools.

WhatsApp MCP Server

Name: WhatsApp MCP Server
Author: lharries

by lharries

communitystdiogithub

View all implementations

6.1kstars|1.2kforks

View on GitHub

Works withClaude DesktopCursorVS CodeWindsurf

About

WhatsApp MCP Server exposes personal WhatsApp search, contacts, and sending tools to MCP-compatible AI clients.

Features

Search personal WhatsApp messages from an MCP client
Read images, videos, documents, and audio-message metadata
Search contacts and send messages to individuals or groups
Send media files through the WhatsApp bridge
Store WhatsApp data locally in SQLite before agent access

Use Cases

Claude Desktop power user

Search recent WhatsApp conversations and contacts while keeping control over which MCP tools the agent can call.

Operations assistant builder

Prototype customer or team communication workflows that need WhatsApp lookup and controlled message sending.

What This Server Can Do

MCP servers expose three types of capabilities to AI clients. Here's what WhatsApp MCP Server supports.

Tools

Supported8 tools

Functions your AI client can call to perform actions — like querying a database, creating a file, or calling an API.

How to use: Tools run automatically when your AI client decides they're needed. Ask your AI assistant to perform a task, and it will invoke the right tool.

Resources

Not available

This server does not expose read-only data resources.

Prompts

Not available

This server does not provide pre-built prompt templates.

For the full list of available tools, resources, and prompts, check the README on GitHub.

Available Tools (3)

search_messages

Search WhatsApp messages stored locally.

list_contacts

Search or list WhatsApp contacts.

send_message

Send a message to an individual or group.