verygoodplugins/whatsapp-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

280 stars 182 forks 品質 80 トレンド 42NOASSERTION

Repository Install

WhatsApp MCPサーバー - メッセージの閲覧と送信のためにClaudeをWhatsAppに接続

概要

WhatsApp用のモデルコンテキストプロトコル(MCP)サーバーで、ClaudeがWhatsAppメッセージを読み送ることを可能にします。元々はルーク・ハリーズによって作成されました。Very Good Pluginsによってメンテナンスされています。 Remotionでシミュレートされたデータを使って生成した製品デモ。 - : 個人のWhatsAppメッセージ(テキスト、画像、動画、ドキュメント、音声)を検索・閲覧 - : 連絡先をsender_display名前または電話番号で形式(「名前(電話)」)で検索 - : 個人やグループにテキストメッセージを送信 - : 画像、動画、文書、音声メッセージの送信・ダウンロード - : 着信の音声・ビデオ通話をローカルSQLiteテーブルにキャプチャ(ライブ、1:1およびグループ) - : 受信メッセージを外部サービスに転送 - : すべてのメッセージはローカルに保存され、許可された場合のみClaudeに送信 - Go 1.25+ - Python 3.11+ - uvパッケージマネージャー - Claude DesktopまたはCursor - FFmpeg(音声メッセージ変換用はオプション) 初回起動時、ブリッジはwhatsapp-bridge/store/.bridge-tokenにローカルのREST APIトークンを印刷・保存します。

概要（AI 翻訳）

WhatsApp用のモデルコンテキストプロトコル(MCP)サーバーで、ClaudeがWhatsAppメッセージを読み送ることを可能にします。

元々はルーク・ハリーズによって作成されました。Very Good Pluginsによってメンテナンスされています。

WhatsApp MCPのデモ動画をご覧ください

Remotionでシミュレートされたデータを使って生成した製品デモ。

特徴

メッセージ管理:個人のWhatsAppメッセージ(テキスト、画像、動画、ドキュメント、音声)を検索・閲覧
連絡先検索:名前または電話番号でsender_display形式(「名前(電話)」)で連絡先を検索
メッセージを送信:個人またはグループにテキストメッセージを送信
既読受信:選択したメッセージをリンクされたデバイス間で明示的に既読としてマークする
メディアサポート:画像、動画、文書、音声メッセージの送信・ダウンロード
通話履歴:着信音声/ビデオ通話をローカルSQLiteテーブル(ライブ、1:1およびグループ)にキャプチャ
Webhook統合:受信メッセージを外部サービスに転送
ローカルストレージ:SQLiteにローカルに保存されるすべてのメッセージ - 許可した場合にのみClaudeに送信されます

設置

前提条件

ゴー 1.26+
Python 3.11+
UVパッケージマネージャー
Claude デスクトップまたはカーソル
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_display format (“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

GitHub で README 全文を見る

インストール

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"
         ]
       }
     }
   }