MCP server WhatsApp Chat Reader
✓ ПровереноПозволяет AI-клиенту анализировать, искать и обобщать историю локальных чатов WhatsApp путем чтения локальной базы данных SQLite.
Также известен как NabheetCloud/wa-chat-reader, wa-chat-reader
- Звёзды
- 1
- Инструменты
- 2
- Загрузки, 30 дней
- 132
- Последняя версия
- 0.1.0
- Последний коммит
- 5 июл. 2026 г.
- Лицензия
- MIT
Что такое WhatsApp Chat Reader MCP?
Позволяет AI-клиенту анализировать, искать и обобщать историю локальных чатов WhatsApp путем чтения локальной базы данных SQLite. Он предоставляет 2 инструмента, например get_whatsapp_messages, get_whatsapp_chat_list.
Сводка сгенерирована из README проекта
О WhatsApp Chat Reader MCP server
Этот инструмент позволяет обобщать и искать информацию в ваших приватных переписках WhatsApp прямо из AI-клиента. Он работает путем чтения локальной базы данных ChatStorage.sqlite, которую использует десктопное приложение WhatsApp на macOS, Windows или Linux. Поскольку сервер полностью запускается на вашей машине и не содержит сетевого кода, данные ваших сообщений остаются локальными и передаются только тому конкретному MCP-клиенту, который вы выберете.
Разработчики могут подключить этот сервер к таким клиентам, как Claude Desktop или Claude Code, используя Python и uv. Сервер предоставляет два специальных инструмента: get_whatsapp_messages для получения текста из личных или групповых чатов и get_whatsapp_chat_list для просмотра списка активных чатов. Для защиты конфиденциальности и производительности переменная окружения WHATSAPP_MAX_DAYS ограничивает глубину поиска, по умолчанию устанавливая окно в 30 дней. Пользователям macOS необходимо предоставить процессу полный доступ к диску (Full Disk Access), чтобы получить доступ к защищенному контейнеру базы данных.
Что вы можете с ним делать
- 1Обобщение активности в группахПопросите ваш AI-клиент составить краткий отчет о сообщениях в конкретных групповых чатах за последние несколько дней.
- 2Поиск активных диалоговЗапросите список всех чатов WhatsApp, в которых вы участвовали в течение текущей недели.
- 3Анализ паттернов общенияСоздавайте офлайн-дашборды в формате HTML для визуализации объема переписки и вашего ежедневного ритма общения.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить WhatsApp Chat Reader MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка WhatsApp Chat Reader MCP в Claude Code
$ claude mcp add wa-chat-reader -- uvx wa-chat-readerУстановка WhatsApp Chat Reader MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"wa-chat-reader": {
"command": "uvx",
"args": [
"wa-chat-reader"
]
}
}
}Установка WhatsApp Chat Reader MCP в VS Code
.vscode/mcp.json
{
"servers": {
"wa-chat-reader": {
"type": "stdio",
"command": "uvx",
"args": [
"wa-chat-reader"
]
}
}
}Установка WhatsApp Chat Reader MCP в VS Code CLI
$ code --add-mcp '{"name":"wa-chat-reader","type":"stdio","command":"uvx","args":["wa-chat-reader"]}'Установка WhatsApp Chat Reader MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"wa-chat-reader": {
"command": "uvx",
"args": [
"wa-chat-reader"
]
}
}
}Установка WhatsApp Chat Reader MCP в Codex
$ codex mcp add wa-chat-reader -- uvx wa-chat-readerУстановка WhatsApp Chat Reader MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.wa-chat-reader] command = "uvx" args = ["wa-chat-reader"]
Установка WhatsApp Chat Reader MCP в Gemini CLI
$ gemini mcp add -s user wa-chat-reader uvx -- wa-chat-readerУстановка WhatsApp Chat Reader MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"wa-chat-reader": {
"command": "uvx",
"args": [
"wa-chat-reader"
]
}
}
}Инструменты WhatsApp Chat Reader MCP 2
Определено из READMEget_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. |
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторий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Не проверялось
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний год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
Открыть на GitHubwa-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 и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Какие инструменты предоставляет WhatsApp Chat Reader MCP?
Он предоставляет 2 инструмента, включая get_whatsapp_messages, get_whatsapp_chat_list.
Отправляются ли мои данные WhatsApp в облако?
Нет, всё работает локально, и данные никогда не покидают ваш компьютер.
Может ли этот сервер изменять или удалять мои сообщения?
Нет, сервер работает в режиме только для чтения (read-only) и использует режим SQLite, который предотвращает любую запись, изменение или удаление.
Какие разрешения требуются в macOS для использования этого инструмента?
Процессу требуется полный доступ к диску (Full Disk Access) в системных настройках, так как база данных WhatsApp находится в защищенном контейнере группы.
Как далеко в прошлое AI может прочитать мои сообщения?
Окно просмотра ограничено переменной WHATSAPP_MAX_DAYS, значение по умолчанию для которой составляет 30 дней.