이것은 WhatsApp용 모델 컨텍스트 프로토콜(MCP) 서버입니다.

이 기능을 통해 개인 Whatsapp 메시지(이미지, 동영상, 문서, 오디오 메시지 포함)를 검색하고 읽을 수 있으며, 연락처를 검색하고 개인이나 그룹에 메시지를 보낼 수 있습니다. 또한 이미지, 동영상, 문서, 오디오 메시지 등 미디어 파일도 보낼 수 있습니다.

WhatsApp 웹 멀티디바이스 API(whatsmeow 라이브러리를 사용)를 통해 개인 WhatsApp 계정에 직접 연결됩니다. 모든 메시지는 SQLite 데이터베이스에 로컬로 저장되며, 에이전트가 도구를 통해 접근할 때만 LLM(예: Claude)으로 전송됩니다(사용자가 직접 제어합니다).

클로드와 연결했을 때 할 수 있는 예시를 소개합니다.

이 프로젝트와 제가 진행 중인 다른 프로젝트에 대한 업데이트를 받으시려면 이메일을 여기로 입력하세요

주의: 많은 MCP 서버와 마찬가지로, WhatsApp MCP도 치명적인 삼중일체의 대상이 됩니다. 즉, 프로젝트 주입이 개인 데이터 유출로 이어질 수 있습니다.

설치

전제 조건

• 가자
• 파이썬 3.6+
• Anthropic Claude 데스크톱 앱(또는 커서)
• UV (Python 패키지 관리자), [[T0]로 설치
• FFmpeg (optional) - 오디오 메시지에만 필요합니다.

WhatsApp MCP Server

This is a Model Context Protocol (MCP) server for WhatsApp.

With this you can search and read your personal Whatsapp messages (including images, videos, documents, and audio messages), search your contacts and send messages to either individuals or groups. You can also send media files including images, videos, documents, and audio messages.

It connects to your personal WhatsApp account directly via the Whatsapp web multidevice API (using the whatsmeow library). All your messages are stored locally in a SQLite database and only sent to an LLM (such as Claude) when the agent accesses them through tools (which you control).

Here’s an example of what you can do when it’s connected to Claude.

To get updates on this and other projects I work on enter your email here

Caution: as with many MCP servers, the WhatsApp MCP is subject to the lethal trifecta. This means that project injection could lead to private data exfiltration.

Installation

Prerequisites

• Go
• Python 3.6+
• Anthropic Claude Desktop app (or Cursor)
• UV (Python package manager), install with curl -LsSf https://astral.sh/uv/install.sh | sh
• FFmpeg (optional) - Only needed for audio messages. If you want to send audio files as playable WhatsApp voice messages, they must be in .ogg Opus format. With FFmpeg installed, the MCP server will automatically convert non-Opus audio files. Without FFmpeg, you can still send raw audio files using the send_file tool.

Steps

1. Clone this repository

   git clone https://github.com/lharries/whatsapp-mcp.git
   cd whatsapp-mcp
   

2. Run the WhatsApp bridge

   Navigate to the whatsapp-bridge directory and run the Go application:

   cd whatsapp-bridge
   go run main.go
   

   The first time you run it, you will be prompted to scan a QR code. Scan the QR code with your WhatsApp mobile app to authenticate.

   After approximately 20 days, you will might need to re-authenticate.

3. Connect to the MCP server

   Copy the below json with the appropriate {{PATH}} values:

   {
     "mcpServers": {
       "whatsapp": {
         "command": "{{PATH_TO_UV}}", // Run `which uv` and place the output here
         "args": [
           "--directory",
           "{{PATH_TO_SRC}}/whatsapp-mcp/whatsapp-mcp-server", // cd into the repo, run `pwd` and enter the output here + "/whatsapp-mcp-server"
           "run",
           "main.py"
         ]
       }
     }
   }
   

   For Claude, save this as claude_desktop_config.json in your Claude Desktop configuration directory at:

   ~/Library/Application Support/Claude/claude_desktop_config.json