WhatsApp MCP Server

Communicationstdio
Repository

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