WhatsApp MCP Server
Communicationstdio
Community MCP server that connects a personal WhatsApp account to AI assistants. Using the WhatsApp multi-device web API, it lets agents search and read your messages and contacts and send messages, including media. Messages are stored locally in SQLite and only shared with the model when the agent accesses them through tools, keeping data on your machine.
Connect
Add this configuration to .claude/mcp.json
{
"mcpServers": {
"whatsapp": {
"command": "npx",
"args": []
}
}
}Tools (3)
search_messages
Search local WhatsApp message history by text, contact, or chat.
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Text to search for"
},
"contact": {
"type": "string",
"description": "Optional contact or chat to scope the search"
}
}
}send_message
Send a WhatsApp message to a contact or group.
{
"type": "object",
"required": [
"recipient",
"message"
],
"properties": {
"message": {
"type": "string",
"description": "Message text to send"
},
"recipient": {
"type": "string",
"description": "Phone number or chat ID of the recipient"
}
}
}list_contacts
List WhatsApp contacts available in the local database.
{
"type": "object",
"properties": {}
}Resources
This server does not expose any resources.
Prompts
This server does not expose any prompts.
Server Information
- Author
- Luke Harries (@lharries)
- Repository
- https://github.com/lharries/whatsapp-mcp
- Stars
- 0
- Last Updated
- July 12, 2026