verygoodplugins/whatsapp-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
WhatsApp MCP 서버 - Claude를 WhatsApp에 연결하여 메시지를 읽고 보내세요
개요
Claude가 WhatsApp 메시지를 읽고 보낼 수 있도록 하는 WhatsApp용 모델 컨텍스트 프로토콜(MCP) 서버입니다. 원래 Luke Harries가 만들었습니다. Very Good Plugins가 유지 관리했습니다. Remotion으로 시뮬레이션 데이터를 사용해 생성한 제품 데모. - : 개인 WhatsApp 메시지(텍스트, 이미지, 동영상, 문서, 오디오) 검색 및 읽기 - : 이름이나 전화번호로 연락처를 sender_display 형식("Name (phone)"으로 검색함 - : 개인 또는 그룹에게 문자 메시지 전송 - : 이미지, 동영상, 문서, 음성 메시지 전송 및 다운로드 - : 수신 음성/영상 통화를 로컬 SQLite 테이블(라이브, 1:1 및 그룹)에 캡처 - : 수신 메시지는 외부 서비스로 전달 - : SQLite에 로컬에 저장된 모든 메시지 - 허용할 때만 Claude로 전송됨 - Go 1.25+ - Python 3.11+ - uv 패키지 관리자 - Claude Desktop 또는 커서 - FFmpeg (음성 메시지 변환을 위한 선택 사항) 첫 시작 시, 브리지는 whatsapp-bridge/store/.bridge-token에 로컬 REST API 토큰을 출력하여 저장합니다.
개요(AI 번역)
Claude가 WhatsApp 메시지를 읽고 보낼 수 있도록 하는 WhatsApp용 모델 컨텍스트 프로토콜(MCP) 서버입니다.
원래 루크 해리스가 만들었습니다. 매우 좋은 플러그인들이 유지보수했습니다.
WhatsApp MCP 데모 영상을 시청하세요
Remotion으로 시뮬레이션 데이터를 사용해 생성한 제품 데모.
특징
- 메시지 관리: 개인 WhatsApp 메시지(텍스트, 이미지, 동영상, 문서, 오디오) 검색 및 읽기
- 연락처 검색:
sender_display형식(“이름 (전화)”)으로 이름 또는 전화번호로 연락처를 검색합니다. - 메시지 전송: 개인 또는 그룹에게 문자 메시지 전송
- 읽음 확인: 선택한 메시지를 연결된 장치 간 읽음으로 명시적으로 표시함
- 미디어 지원: 이미지, 동영상, 문서, 음성 메시지 전송 및 다운로드
- 통화 기록: 들어오는 음성/영상 통화를 로컬 SQLite 테이블(생중, 1:1 및 그룹)에 캡처함
- 웹훅 통합: 수신 메시지를 외부 서비스로 전달합니다
- 로컬 저장소: SQLite에 로컬에 저장된 모든 메시지 - 허용할 때만 Claude로 전송됨
설치
전제 조건
- Go 1.26+
- 파이썬 3.11+
- UV 패키지 관리자
- 클로드 데스크톱 또는 커서
- FFmpeg (음성 메시지 변환을 위한 선택 사항)
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
README
원문 README의 일부입니다. 원문 보기.
WhatsApp MCP Server
A Model Context Protocol (MCP) server for WhatsApp, enabling Claude to read and send WhatsApp messages.
Originally created by Luke Harries. Maintained by Very Good Plugins.
Watch the WhatsApp MCP demo video
Product demo generated with Remotion using simulated data.
Features
- Message Management: Search and read personal WhatsApp messages (text, images, videos, documents, audio)
- Contact Search: Search contacts by name or phone number with
sender_displayformat (“Name (phone)”) - Send Messages: Send text messages to individuals or groups
- Read Receipts: Explicitly mark selected messages as read across linked devices
- Media Support: Send and download images, videos, documents, and voice messages
- Call History: Capture incoming voice/video calls into a local SQLite table (live, 1:1 and group)
- Webhook Integration: Forward incoming messages to external services
- Local Storage: All messages stored locally in SQLite - only sent to Claude when you allow it
Installation
Prerequisites
- Go 1.26+
- Python 3.11+
- uv package manager
- Claude Desktop or Cursor
- FFmpeg (optional, for voice message conversion)
Intel macOS: patched cryptography releases no longer provide Intel Mac
wheels, so installation may compile this dependency from source. Install the
Xcode Command Line Tools (xcode-select --install) and, with Homebrew,
brew install rust openssl@3 pkg-config. Then install the Python dependencies:
cd whatsapp-mcp-server
OPENSSL_DIR="$(brew --prefix openssl@3)" uv sync
Use a Rust toolchain supported by the installed cryptography release; see its
source-build instructions.
Keep the patched dependency rather than restoring the old vulnerable version pin.
Quick Start
-
Clone the repository
git clone https://github.com/verygoodplugins/whatsapp-mcp.git cd whatsapp-mcp -
Start the WhatsApp bridge
cd whatsapp-bridge go run .On first start, the bridge prints and stores a local REST API token at
설치
This server does not publish a one-line install command.
Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →설정
{
"mcpServers": {
"whatsapp": {
"command": "uv",
"args": [
"--directory",
"/path/to/whatsapp-mcp/whatsapp-mcp-server",
"run",
"main.py"
]
}
}
}