MCP.Market

WhatsApp Chat Reader (Unofficial) MCP server

by NabheetCloud·io.github.NabheetCloud/wa-chat-reader·v0.1.0·1 stars
No reviews yet

Unofficial read-only MCP server for your local WhatsApp chat history (stays on your machine).

A88/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A88/100

full report

Adoption
New

1 stars

Reviews

Write one

Nobody has reviewed WhatsApp Chat Reader (Unofficial) yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

WhatsApp Chat Reader (Unofficial) tools (2)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • get_whatsapp_chat_list

    List active WhatsApp chat names (groups and personal) within a look-back window, without message bodies. Read-only.

  • get_whatsapp_messages

    Read concatenated WhatsApp text messages from group and personal chats within a look-back window. Read-only; nothing is sent off the machine.

Public scan report

scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it

no findings
  • Code scan3 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 83 days ago12/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 88/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How WhatsApp Chat Reader (Unofficial) compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
88/100
higher than 75% of 48,273 servers
Tools
2
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
1
more than 65% of 28,534 servers

What its tools let an agent do: 2 read

Install WhatsApp Chat Reader (Unofficial) in Claude Code, Cursor or VS Code

claude mcp add wa-chat-reader -- uvx wa-chat-reader
Add to Cursor

What the publisher says

From the WhatsApp Chat Reader (Unofficial) repository's README, as published. We do not edit it. Read it on GitHub

wa-chat-reader

<!-- mcp-name: io.github.NabheetCloud/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.

never writes to, modifies, or deletes anything.

  • Read-only. The database is opened with SQLite mode=ro&immutable=1; the server

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.

  • Local-only. There is no network code. Messages are returned to your MCP client

chats. Do not use it to access anyone else's messages.

  • Your consent, your data. Only run this against your own device and your own

process running this server needs Full Disk Access (System Settings → Privacy & Security → Full Disk Access), or point WHATSAPPDBPATHS at a readable copy you export yourself.

  • macOS access. The WhatsApp database lives in a protected group container. The

call can read.

  • Scope control. WHATSAPPMAXDAYS (default 30) caps how far back any single

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):

Default database locations:

Tools

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

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

WhatsApp Chat Reader (Unofficial): common questions

Is WhatsApp Chat Reader (Unofficial) MCP server safe?
Yes, by our scan: it is graded A (88/100). Read the WhatsApp Chat Reader (Unofficial) safety report
How do I install WhatsApp Chat Reader (Unofficial)?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does WhatsApp Chat Reader (Unofficial) need an API key?
No secret keys are declared. It reads 5 settings from the environment.
Is WhatsApp Chat Reader (Unofficial) maintained?
The last commit was 120 days ago (2026-07-05). The latest release is v0.1.0.
How does WhatsApp Chat Reader (Unofficial) compare with other MCP servers?
safety score 88/100 (higher than 75% of 48,273 servers); tools 2 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.