WhatsApp Chat Reader (Unofficial)
What it does
Unofficial read-only MCP server for your local WhatsApp chat history (stays on your machine).
- Connects パソコンで動く
- Account or key No key needed
- Category チャット・メール
インストール
使っているAIアプリを選んで、設定をコピーしてください。
チェック 3/3 合格 · あなたのパソコンで動きます
まず：どの AI を使っていますか？
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
WhatsApp Chat Reader (Unofficial) のキーが必要です（提供元のサイトで作成） · 先にパソコンへ Python (uv) を入れてください（1 回だけ） · パソコン版 Claude アプリ（Windows または Mac）のみ。Web やスマホでは使えません
WhatsApp Chat Reader (Unofficial) に登録してキーを作る
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
パソコン版 Claude アプリの設定ファイルを開く
SettingsDeveloperEdit Config
この設定を貼り付けて保存
{ "mcpServers": { "wa-chat-reader": { "command": "uvx", "args": [ "wa-chat-reader" ], "env": { "WHATSAPP_DB_PATHS": "your-value", "WHATSAPP_BACKUP_PATHS": "your-value", "WHATSAPP_MAX_DAYS": "your-value", "WHATSAPP_DEBUG": "your-value", "WHATSAPP_LOG_FILE": "your-value" } } } }キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Claude を終了してもう一度開く
試してみる
WhatsApp Chat Reader (Unofficial) を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が WhatsApp Chat Reader (Unofficial) を使っていると言うか、回答に WhatsApp Chat Reader (Unofficial) のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ WhatsApp Chat Reader (Unofficial) につなげません
WhatsApp Chat Reader (Unofficial) はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
代わりにできること
A · WhatsApp Chat Reader (Unofficial) につなげるアプリを使う
- WhatsApp Chat Reader (Unofficial) のキーが必要です（提供元のサイトで作成） · 先にパソコンへ Python (uv) を入れてください（1 回だけ） · パソコン版 Claude アプリ（Windows または Mac）のみ。Web やスマホでは使えません
- WhatsApp Chat Reader (Unofficial) のキーが必要です（提供元のサイトで作成） · 先にパソコンへ Python (uv) を入れてください（1 回だけ）
- WhatsApp Chat Reader (Unofficial) のキーが必要です（提供元のサイトで作成） · 先にパソコンへ Python (uv) を入れてください（1 回だけ）
- WhatsApp Chat Reader (Unofficial) のキーが必要です（提供元のサイトで作成） · 先にパソコンへ Python (uv) を入れてください（1 回だけ）
B · チャット・メール の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
- Inbox Zero✓ ChatGPT
- draw.io✓ ChatGPT
- TradingMCP✓ ChatGPT
Claude Code につなげますが、先に準備が必要です
WhatsApp Chat Reader (Unofficial) のキーが必要です（提供元のサイトで作成） · 先にパソコンへ Python (uv) を入れてください（1 回だけ）
WhatsApp Chat Reader (Unofficial) に登録してキーを作る
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
ターミナルを開く
Mac：Command+スペースで Terminal と入力 · Windows：PowerShell を開く
このコマンドを貼り付けて Enter
claude mcp add --scope user wa-chat-reader --env WHATSAPP_DB_PATHS=your-value --env WHATSAPP_BACKUP_PATHS=your-value --env WHATSAPP_MAX_DAYS=your-value --env WHATSAPP_DEBUG=your-value --env WHATSAPP_LOG_FILE=your-value -- uvx wa-chat-readerEnter の前に「your-value」を自分のキーに書き換えてください
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Claude Code で /mcp と入力
WhatsApp Chat Reader (Unofficial) が一覧にあり、接続済みと表示されれば OK です
試してみる
WhatsApp Chat Reader (Unofficial) を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が WhatsApp Chat Reader (Unofficial) を使っていると言うか、回答に WhatsApp Chat Reader (Unofficial) のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
WhatsApp Chat Reader (Unofficial) のキーが必要です（提供元のサイトで作成） · 先にパソコンへ Python (uv) を入れてください（1 回だけ）
WhatsApp Chat Reader (Unofficial) に登録してキーを作る
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
キーを入力
WhatsApp Chat Reader (Unofficial) の設定で WHATSAPP_DB_PATHS, WHATSAPP_BACKUP_PATHS, WHATSAPP_MAX_DAYS, WHATSAPP_DEBUG, WHATSAPP_LOG_FILE が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Cursor の AI チャットを Agent モードで開く
試してみる
WhatsApp Chat Reader (Unofficial) を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が WhatsApp Chat Reader (Unofficial) を使っていると言うか、回答に WhatsApp Chat Reader (Unofficial) のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
WhatsApp Chat Reader (Unofficial) のキーが必要です（提供元のサイトで作成） · 先にパソコンへ Python (uv) を入れてください（1 回だけ）
WhatsApp Chat Reader (Unofficial) に登録してキーを作る
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
キーを入力
WhatsApp Chat Reader (Unofficial) の設定で WHATSAPP_DB_PATHS, WHATSAPP_BACKUP_PATHS, WHATSAPP_MAX_DAYS, WHATSAPP_DEBUG, WHATSAPP_LOG_FILE が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
VS Code の AI チャットを Agent モードで開く
試してみる
WhatsApp Chat Reader (Unofficial) を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が WhatsApp Chat Reader (Unofficial) を使っていると言うか、回答に WhatsApp Chat Reader (Unofficial) のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください
JSON 設定は下の「開発者向け」にあります
開発者向け：ターミナルのコマンドと JSON 設定
パソコンにインストール
Claude Code
claude mcp add --scope user wa-chat-reader --env WHATSAPP_DB_PATHS=your-value --env WHATSAPP_BACKUP_PATHS=your-value --env WHATSAPP_MAX_DAYS=your-value --env WHATSAPP_DEBUG=your-value --env WHATSAPP_LOG_FILE=your-value -- uvx wa-chat-readerClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"wa-chat-reader": {
"command": "uvx",
"args": [
"wa-chat-reader"
],
"env": {
"WHATSAPP_DB_PATHS": "your-value",
"WHATSAPP_BACKUP_PATHS": "your-value",
"WHATSAPP_MAX_DAYS": "your-value",
"WHATSAPP_DEBUG": "your-value",
"WHATSAPP_LOG_FILE": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"wa-chat-reader": {
"command": "uvx",
"args": [
"wa-chat-reader"
],
"env": {
"WHATSAPP_DB_PATHS": "your-value",
"WHATSAPP_BACKUP_PATHS": "your-value",
"WHATSAPP_MAX_DAYS": "your-value",
"WHATSAPP_DEBUG": "your-value",
"WHATSAPP_LOG_FILE": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"wa-chat-reader": {
"type": "stdio",
"command": "uvx",
"args": [
"wa-chat-reader"
],
"env": {
"WHATSAPP_DB_PATHS": "your-value",
"WHATSAPP_BACKUP_PATHS": "your-value",
"WHATSAPP_MAX_DAYS": "your-value",
"WHATSAPP_DEBUG": "your-value",
"WHATSAPP_LOG_FILE": "your-value"
}
}
}
}自分で入力する値
WHATSAPP_DB_PATHSenvSemicolon-separated paths to ChatStorage.sqlite. If unset, a platform default is used.WHATSAPP_BACKUP_PATHSenvSemicolon-separated fallback database paths, tried after the primary paths.WHATSAPP_MAX_DAYSenvMaximum look-back window in days a caller may request.WHATSAPP_DEBUGenvSet to 'true' for verbose logging to stderr.WHATSAPP_LOG_FILEenvOptional path to also write logs to a file.
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
ひと目でわかる
使えるアプリ
このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
できること
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
基本チェックi
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月12日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント NabheetCloud で確認済みです
- ✓ 合格
今もメンテナンスされている
コードの最終更新：4 か月前
- ✓ 合格
ライセンスがある
MITを使用
- – 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
- – 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
- … 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
話し合い
質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
ユーザーレビュー
まだレビューはありません
チャット・メールのほかのサーバーとの比較i
- このカテゴリのほかの1974件のうち83%よりスターが多い
- このカテゴリのほかの1974件のうち14%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの1974件のうち100%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
WhatsApp Chat Reader (Unofficial)は安全ですか？
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか？
レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。
パソコンで動きますか、それともクラウドですか？
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。
今もメンテナンスされていますか？
GitHubリポジトリの最終更新は4 か月前、最新バージョン（0.1.0）がレジストリに届いたのは4 か月前です。
どのアプリで使えますか？
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。
代わりに使えるものは？
同じカテゴリには：Inbox Zero, draw.io, TradingMCP
同じカテゴリのほかの候補
同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。
カードの見方：↓ 週あたりのダウンロードi★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i
draw.io
Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.
TradingMCP
Market analysis for AI assistants: screeners, multi-timeframe analysis, backtests, in-chat charts.
作者のREADME
READMEを開く
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
wa-chat-reader
Unofficial, read-only [MCP](https://modelcontextprotocol.io) 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-readerOr 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.htmlThe generated HTML contains real contact names — it is git-ignored and meant to stay local.
Develop
git clone https://github.com/NabheetCloud/wa-chat-readercd wa-chat-reader pip install -e . python3 simple_whatsapp_mcp.py # run from source without installing
License
MIT © 2026 Nabheet Madan