WhatsApp Chat Reader MCPサーバー
✓ 検証済みローカルのSQLiteデータベースを読み取ることで、AIクライアントがローカルのWhatsAppチャット履歴の要約、検索、推論を行うことを可能にします。
別名 NabheetCloud/wa-chat-reader, wa-chat-reader
- スター
- 1
- ツール
- 2
- ダウンロード数(30日間)
- 132
- 最新バージョン
- 0.1.0
- 最終コミット
- 2026年7月5日
- ライセンス
- MIT
WhatsApp Chat Reader MCPとは
ローカルのSQLiteデータベースを読み取ることで、AIクライアントがローカルのWhatsAppチャット履歴の要約、検索、推論を行うことを可能にします。 2個のツールを提供しており、get_whatsapp_messages, get_whatsapp_chat_listなどがあります。
プロジェクトのREADMEから生成された概要
WhatsApp Chat Reader MCP server について
このツールを使用すると、AIクライアント内からプライベートなWhatsAppの会話を要約したり検索したりできるようになります。macOS、Windows、またはLinux上のWhatsAppデスクトップアプリケーションで使用されているローカルの ChatStorage.sqlite データベースを読み取ることで動作します。このサーバーはネットワークコードを使用せず、完全にローカルマシン上で動作するため、メッセージデータはローカルに保持され、選択した特定のMCPクライアントとの間でのみ共有されます。
開発者は、Pythonとuvを使用して、このサーバーをClaude DesktopやClaude Codeなどのクライアントに接続できます。このサーバーは、個人またはグループチャットからテキストを取得する get_whatsapp_messages と、アクティブなチャット名を表示する get_whatsapp_chat_list という2つの特定のツールを提供します。プライバシーとパフォーマンスを保護するため、環境変数 WHATSAPP_MAX_DAYS によってAIが遡れる期間が制限されており、デフォルトでは30日間に設定されています。macOSのユーザーは、保護されたデータベースコンテナにアクセスするために、プロセスにフルディスクアクセスを許可する必要があります。
できること
- 1最近のグループ活動の要約特定のグループチャットにおけるここ数日間のメッセージの要約をAIクライアントに依頼します。
- 2アクティブな会話の特定今週参加したすべてのWhatsAppチャットのリストをリクエストします。
- 3メッセージングパターンの分析メッセージの量や日々のリズムを可視化するための、オフラインのHTMLダッシュボードを生成します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
WhatsApp Chat Reader MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにWhatsApp Chat Reader MCPをインストール
$ claude mcp add wa-chat-reader -- uvx wa-chat-readerCursorにWhatsApp Chat Reader MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"wa-chat-reader": {
"command": "uvx",
"args": [
"wa-chat-reader"
]
}
}
}VS CodeにWhatsApp Chat Reader MCPをインストール
.vscode/mcp.json
{
"servers": {
"wa-chat-reader": {
"type": "stdio",
"command": "uvx",
"args": [
"wa-chat-reader"
]
}
}
}VS Code CLIにWhatsApp Chat Reader MCPをインストール
$ code --add-mcp '{"name":"wa-chat-reader","type":"stdio","command":"uvx","args":["wa-chat-reader"]}'Claude DesktopにWhatsApp Chat Reader MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"wa-chat-reader": {
"command": "uvx",
"args": [
"wa-chat-reader"
]
}
}
}CodexにWhatsApp Chat Reader MCPをインストール
$ codex mcp add wa-chat-reader -- uvx wa-chat-readerCodex config.tomlにWhatsApp Chat Reader MCPをインストール
~/.codex/config.toml
[mcp_servers.wa-chat-reader] command = "uvx" args = ["wa-chat-reader"]
Gemini CLIにWhatsApp Chat Reader MCPをインストール
$ gemini mcp add -s user wa-chat-reader uvx -- wa-chat-readerGemini settings.jsonにWhatsApp Chat Reader MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"wa-chat-reader": {
"command": "uvx",
"args": [
"wa-chat-reader"
]
}
}
}WhatsApp Chat Reader MCPツール 2
READMEから検出get_whatsapp_messagesget_whatsapp_chat_list
| get_whatsapp_messages | — | |
| get_whatsapp_chat_list | — |
設定
WHATSAPP_BACKUP_PATHSSemicolon-separated fallback database paths, tried after the primary paths.
WHATSAPP_DB_PATHSSemicolon-separated paths to ChatStorage.sqlite. If unset, a platform default is used.
WHATSAPP_DEBUGSet to 'true' for verbose logging to stderr.
WHATSAPP_LOG_FILEOptional path to also write logs to a file.
WHATSAPP_MAX_DAYSMaximum look-back window in days a caller may request.
| 名前 | 説明 | 種類 |
|---|---|---|
| WHATSAPP_BACKUP_PATHS | Semicolon-separated fallback database paths, tried after the primary paths. | |
| WHATSAPP_DB_PATHS | Semicolon-separated paths to ChatStorage.sqlite. If unset, a platform default is used. | |
| WHATSAPP_DEBUG | Set to 'true' for verbose logging to stderr. | |
| WHATSAPP_LOG_FILE | Optional path to also write logs to a file. | |
| WHATSAPP_MAX_DAYS | Maximum look-back window in days a caller may request. |
自動チェック
実行日 2026年11月14日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能nabheetcloud/wa-chat-reader is public and reachablegithub.com/nabheetcloud/wa-chat-reader ↗合格
- パッケージがこのリポジトリをソースとして指定wa-chat-reader names nabheetcloud/wa-chat-reader as sourcepypi.org/project/wa-chat-reader/ ↗合格
- ビルドの来歴 (Sigstore 証明)No build attestation published for this release未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-07-05github.com/nabheetcloud/wa-chat-reader ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from wa-chat-reader合格
- パッケージおよびその依存関係に重大な勧告なし29 resolved dependencies checked; no critical advisoryosv.dev ↗合格
- モデルへの隠れた指示がない2 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされているNo tool named like delete, drop or exec合格
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るwa-chat-reader
Unofficial, read-only MCP server for your local WhatsApp chat history.
wa-chat-reader reads the WhatsApp ChatStorage.sqlite database that the WhatsApp
desktop app keeps on your machine and exposes two tools to any MCP client (Claude
Code, Claude Desktop, etc.) so you can summarize, search, and reason over your own
messages. Everything runs locally — no data ever leaves your computer.
⚠️ Not affiliated with, endorsed by, or connected to WhatsApp or Meta. "WhatsApp" is a trademark of Meta Platforms, Inc. This is an independent, unofficial tool that only reads a database WhatsApp already stores on your device.
Privacy & security
This tool touches highly sensitive data — your private conversations. Read this first.
- Read-only. The database is opened with SQLite
mode=ro&immutable=1; the server never writes to, modifies, or deletes anything. - Local-only. There is no network code. Messages are returned to your MCP client and nowhere else. Whatever LLM/client you connect will, of course, see the message text you ask it to read — you control that by choosing which client to run.
- Your consent, your data. Only run this against your own device and your own chats. Do not use it to access anyone else's messages.
- macOS access. The WhatsApp database lives in a protected group container. The
process running this server needs Full Disk Access
(System Settings → Privacy & Security → Full Disk Access), or point
WHATSAPP_DB_PATHSat a readable copy you export yourself. - Scope control.
WHATSAPP_MAX_DAYS(default 30) caps how far back any single call can read.
Install
Requires Python ≥ 3.10. Recommended: uv so the server
runs in an isolated environment.
# one-shot run (no install)
uvx wa-chat-reader
# or install with pip
pip install wa-chat-reader
wa-chat-reader
Use in Claude Code
claude mcp add wa-chat-reader -- uvx wa-chat-reader
Or install as a plugin (see the marketplace section below), then ask Claude things like:
- "Summarize my unread WhatsApp group chats from the last 3 days."
- "List the WhatsApp chats I've been active in this week."
Configuration
All configuration is via environment variables (all optional):
| Variable | Default | Description |
|---|---|---|
WHATSAPP_DB_PATHS |
platform default | ;-separated candidate paths to ChatStorage.sqlite (first readable wins) |
WHATSAPP_BACKUP_PATHS |
— | ;-separated fallback paths, tried after the primary paths |
WHATSAPP_MAX_DAYS |
30 |
Max look-back window (days) a caller may request |
WHATSAPP_DEBUG |
false |
true for verbose logging to stderr |
WHATSAPP_LOG_FILE |
— | Optional path to also write logs to a file |
Default database locations:
| OS | Path |
|---|---|
| macOS | ~/Library/Group Containers/group.net.whatsapp.WhatsApp.shared/ChatStorage.sqlite |
| Windows | ~/AppData/Roaming/WhatsApp/Databases/ChatStorage.sqlite |
| Linux | ~/.local/share/whatsapp/ChatStorage.sqlite |
Tools
| Tool | Description |
|---|---|
get_whatsapp_messages |
Concatenated message text from group and personal chats within a look-back window. Params: days (1–max), chat_type (all/groups/personal). Read-only. |
get_whatsapp_chat_list |
Active chat names (no message bodies) within a look-back window. Param: days. Read-only. |
Both tools are annotated readOnlyHint: true.
Bonus: activity dashboard
whatsapp_dashboard.py renders a self-contained, offline HTML dashboard of your
messaging activity (volume over time, daily/weekly rhythm, top chats) straight from
the same database:
python3 whatsapp_dashboard.py # -> whatsapp_dashboard.html
The generated HTML contains real contact names — it is git-ignored and meant to stay local.
Develop
git clone https://github.com/NabheetCloud/wa-chat-reader
cd wa-chat-reader
pip install -e .
python3 simple_whatsapp_mcp.py # run from source without installing
License
MIT © 2026 Nabheet Madan
WhatsApp Chat Reader MCPのよくある質問
WhatsApp Chat Reader MCPをClaude Codeに追加するには
ターミナルでclaude mcp add wa-chat-reader -- uvx wa-chat-readerを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
WhatsApp Chat Reader MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
WhatsApp Chat Reader MCPが提供するツールは
2個のツールを提供しており、get_whatsapp_messages, get_whatsapp_chat_listなどがあります。
WhatsAppのデータはクラウドに送信されますか?
いいえ、すべてローカルで実行されるため、データがコンピュータから外部に送信されることはありません。
このサーバーはメッセージの変更や削除ができますか?
いいえ、このサーバーは読み取り専用です。書き込み、変更、削除を防止するSQLiteモードを使用しています。
macOSで使用するために必要な権限は何ですか?
WhatsAppのデータベースは保護されたグループコンテナ内にあるため、システム設定でこのプロセスに「フルディスクアクセス」を許可する必要があります。
AIはどのくらい過去のメッセージまで読み取れますか?
遡れる期間は WHATSAPP_MAX_DAYS 変数によって制限されており、デフォルトは30日です。