MIDREAL

Home / whatsapp-mcp

finereli

whatsapp-mcp

WatchingWatchingNone of the above. Nothing stands out yet. More on the methodology page

finereli/whatsapp-mcp

A read-only MCP server that lets your AI agent search and read your own WhatsApp messages. Use it free at whatsapp.finereli.com, or run your own copy on Cloudflare.

TypeScriptCategories: MCP

Our summary

A read-only MCP server that lets an AI agent search and read the user's own WhatsApp messages. The user links their phone as a device, and messages are stored encrypted in a Cloudflare Durable Object. It can be used as a hosted service or run as a self-hosted copy.

Who it is for: People who want an AI agent to search and read their own WhatsApp messages

What the README claims

  • Read-only: no tools send, edit or delete anything in WhatsApp There are no tools that send, edit or delete anything in WhatsApp. Not checked
  • Stored messages are encrypted at rest with a key derived from the user's password The data key is stored only in a form locked by that password or login key (PBKDF2-SHA256, 600,000 rounds for a password Not checked
  • Phone numbers and chat ids are replaced by keyed hashes in the database Phone numbers and chat ids are replaced by keyed hashes in the database Not checked
  • Search uses a filter per block of about 128 messages to skip blocks that cannot match Search uses a filter per block of about 128 messages, built from keyed hashes of the words in it Not checked
  • Runs as a self-hosted copy on Cloudflare or locally under Docker The same Worker runs on your own machine under workerd Not checked

Written by AI from the project's README on 2026-11-17. It does not affect the verdict.

Watching: no other rule matched yet.

7-day star gain 7, level with 7 the week before.

Gaining 7 stars this week. Last push today.

Verdict

SLEEPER scored 1h ago

Hype
26
Reality
79
Hype Gap
-53
Momentum
-
Confidence
60%
  • Responsive moves Reality +9 points.
  • Maintained moves Reality +9 points.

Rule verdict-2.0, scoring score-2.0. How we score. Backtest.

Find them on

Maintained by

Maintained by 1 primary developer, 3 external contributors in the last 90 days.

  • finereli is a GitHub individual account.
  • GitHub account created May 2011.
  • Top contributors by commits: finereli 68%, claude 23%, mateuscmarim 6%.

Why now 2% of its stars arrived in the last 7 days. No Hacker News posts in the last 7 days.

Stars StarsThe number of GitHub stars on the repository at our latest reading.
424
Gain 7d Gain 7dStars gained since our latest reading from at least 7 days ago.
+7
Pace Velocity (Nx usual pace)This week's star gain divided by the project's usual weekly gain. The usual gain is the average weekly gain over the 4 weeks before (days 8 to 35 ago), counted as at least 10 stars. 2.0x means twice the usual pace. Without a reading from 35 days ago, the ranking assumes 2% of the stars the project had 7 days ago as its usual weekly gain. More on the methodology page
0.7x
HN points HN pointsHacker News points added up across posts that mention the project, published in the last 7 days.
0 7 days
Downloads DownloadsDownloads per day of the project's package, as the registry (npm or PyPI) reports them.
n/a
Contributors Contributors, all timePeople and anonymous contributors who have ever committed to the repository, as GitHub counts them. A small number is context, not a flaw: many solid projects are kept by one or two people.
4
Last release Latest releaseDays since the latest GitHub release was published.
n/a

Gain 24h Gain 24hStars gained since our latest reading from at least 24 hours ago. 0. Forks ForksThe number of GitHub forks of the repository at our latest reading. 38. Open issues Open issuesThe number of open issues on the repository at our latest reading, as GitHub counts them. 1. Days since push Days since pushDays since the last push to the repository. 0 days. Archived ArchivedWhether the owner has archived the repository on GitHub. An archived repository is read-only. no. Hacker News posts in 7 days Hacker News postsThe number of Hacker News posts that mention the project, published in the last 7 days.: 0. Watchers WatchersThe number of GitHub users watching the repository for notifications, at our latest reading. 0.

Facts

License
MIT source, checked 22 Nov 2026
Language
TypeScript source, checked 22 Nov 2026
Homepage
https://whatsapp.finereli.com source, checked 22 Nov 2026
Releases
0 source, checked 19 Nov 2026
Contributors
4 source, checked 19 Nov 2026
Archived
no source, checked 22 Nov 2026

Nerd stuff

DockerSelf-hosted

Languages
TypeScript (detected), JavaScript (detected), Shell (detected), Dockerfile (detected)
Deployment
Docker Compose (detected), Docker (detected)
License
MIT (detected)
Package ecosystem
npm (detected)

The Receipts

SourceEvidenceDate
Hacker NewsThread, 157 points, 85 comments18 Oct 2026

What changed recently

GitHub release dates we stored. We do not track license changes yet.

Cite this

whatsapp-mcp is a GitHub project at https://github.com/finereli/whatsapp-mcp written mainly in TypeScript, described there as "A read-only MCP server that lets your AI agent search and read your own WhatsApp messages. Use it free at whatsapp.finereli.com, or run your own copy on Cloudflare".

Source: https://midorreal.com/project/finereli-whatsapp-mcp, checked 22 November 2026. The same facts as JSON: /project/finereli-whatsapp-mcp.json.

Rank history

Peak day: +26 stars on 20 Oct 2026, 33 days ago.

Best rank on Blowing up: #55 on 26 Oct 2026.

Stars

23 Oct 202621 Nov 2026
Stars each day Stars each dayThe highest star count we recorded on each day., last 34 days. Without JavaScript this shows the last 30 days.
Stars gained each day Stars gained each dayThe difference in the daily peak star count between consecutive days that both have a reading., between readings on consecutive days. Last 30 days in the fallback.

Packages

- We checked npm, PyPI, Docker Hub, crates.io and Homebrew and found no package that links to this repository.

Signals

SourceWhat we measuredChecked
GitHub424 stars, 7 gained in 7 days21 Nov 2026
Hacker News1 post stored, 0 points in the last 7 days25 Oct 2026
Feed mentionsNot tracked yet-
npmNo linked package found-
PyPINo linked package found-
Docker HubNo linked package found-
crates.ioNo linked package found-
HomebrewNo linked package found-
deps.devNot tracked yet-
Hugging FaceNot tracked yet-
BlueskyNot tracked yet-
Stack ExchangeNot tracked yet-
YouTubeNot tracked yet-

Attention vs adoption

Attention: above 58% of tracked projects 58%
Star velocity against all tracked projects

Adoption: not enough data to rank
Downloads, dependents and pulls

Not enough comparable data yet to set attention against adoption. This describes the numbers; it is not a verdict.

Compared with MCP

MeasureThis projectCategory median
Star velocity0.70.4
Days since releaseno data3.7
Contributors, all time42
Median time to first reply on issues3 days13 hours
Commits in the last 30 days2253

Star velocity: above 60% of MCP projects

Contributors, all time: above 63% of MCP projects

Median time to first reply on issues: above 64% of MCP projects

Commits in the last 30 days: above 38% of MCP projects

Compared with the project's first category only. A percentile line appears only where at least 30 projects in the category have the measure. This describes the numbers; it is not a verdict.

Compare with

Hacker News

Points by day Hacker News points by dayPoints on Hacker News posts that mention the project, grouped by the day each post was published. across 1 post and 1 day, 157 points in total.
PostPoints PointsThe points the post has on Hacker News.Comments CommentsThe number of comments on the post on Hacker News.Date
Hacker News post 157 85 18 Oct 2026

Caveats

  • The repository has no security policy on GitHub. Source
  • The repository has 0 releases on GitHub. Source

Repo health

  • Languages LanguagesShare of the repository's code by bytes, as GitHub's language detection reports it. The five biggest languages are named and the rest are grouped as Other.TypeScript 96%, JavaScript 4%
  • License LicenseThe SPDX license id GitHub detects, and a class: Open source (OSI) if the license is on the Open Source Initiative approved list, Source-available if the code is readable but the license limits use, Unclear if GitHub cannot match a known license, No license detected if it finds none. A public repository without a license is not open source.MIT, Open source (OSI)
  • Repository age Repository ageTime since the repository was created on GitHub. This is the repository, not necessarily the project, which may have existed elsewhere before.34 days, created 18 Oct 2026

Development

  • Commits in the last 7 days Commits in the last 7 daysCommits to the repository in the last 7 days, as GitHub counts them.0
  • Commits in the last 30 days Commits in the last 30 daysCommits to the repository in the last 30 days, as GitHub counts them.22
  • Commits in the last 90 days Commits in the last 90 daysCommits to the repository in the last 90 days, as GitHub counts them.31
  • Contributors, all time Contributors, all timePeople and anonymous contributors who have ever committed to the repository, as GitHub counts them. A small number is context, not a flaw: many solid projects are kept by one or two people.4
  • Releases ReleasesThe number of GitHub releases, and how many days ago the latest one was published.0
  • Issues in the last 30 days Issues in the last 30 daysIssues opened and issues closed in the last 30 days, as GitHub search counts them.3 opened, 3 closed
  • Pull requests merged in the last 30 days Pull requests merged in the last 30 daysPull requests merged in the last 30 days, as GitHub search counts them.2

Maintenance

  • Median time to first reply on issues Median time to first reply on issuesMedian time between an issue being opened and the first comment from someone other than its author, over a sample of the last 30 closed issues. Issues with no reply are left out of the median and counted separately.3 days
  • Median time to close issues Median time to close issuesMedian time from opening to closing, over a sample of the last 30 closed issues.3 days
  • Sampled issues with no reply Sampled issues with no replyHow many of the sampled closed issues never got a comment from someone other than their author.1 of 3
  • Stale open issues Stale open issuesOpen issues with no update in the last 90 days, as GitHub search counts them.0
  • Open pull requests Open pull requestsPull requests open now, as GitHub search counts them.1

Hygiene

  • Automated tests or builds (CI) Automated tests or builds (CI)Whether the repository has at least one GitHub Actions workflow file in .github/workflows.No
  • A tests folder A tests folderWhether the repository has a top-level folder named tests, test, __tests__ or spec.Yes
  • A license A licenseWhether GitHub detects a license file in the repository.Yes
  • Contributing guide Contributing guideWhether the repository has a contributing guide.No
  • Code of conduct Code of conductWhether GitHub finds a code of conduct in the repository.No
  • CODEOWNERS file CODEOWNERS fileWhether the repository has a CODEOWNERS file, which names who reviews changes to which files.No
  • A Dockerfile A DockerfileWhether the repository has a Dockerfile at its top level.Yes

Security

  • Security policy Security policyWhether the repository has a SECURITY.md or SECURITY.rst file.No
  • Unpatched high or critical advisories Unpatched high or critical advisoriesPublished GitHub security advisories rated high or critical on this repository that list a vulnerable version with no patched version.0

Badge

For maintainers: one measured fact, no verdict. First spotted by Mid or Real at 17 stars on 18 Oct 2026

Markdown

[![Mid or Real](https://midorreal.com/badge/finereli-whatsapp-mcp.svg)](https://midorreal.com/project/finereli-whatsapp-mcp)

HTML

<a href="https://midorreal.com/project/finereli-whatsapp-mcp"><img src="https://midorreal.com/badge/finereli-whatsapp-mcp.svg" alt="Mid or Real"></a>

Verdict badge: Mid or Real: SLEEPER It shows the verdict as this page shows it today.

Markdown

[![Mid or Real: SLEEPER](https://midorreal.com/badge/finereli-whatsapp-mcp.svg?style=verdict)](https://midorreal.com/project/finereli-whatsapp-mcp)

HTML

<a href="https://midorreal.com/project/finereli-whatsapp-mcp"><img src="https://midorreal.com/badge/finereli-whatsapp-mcp.svg?style=verdict" alt="Mid or Real: SLEEPER"></a>

Passport

Copy these facts into a post, a README or a page. Cite as "Source: Mid or Real". Full record: JSON.




First tracked 18 Oct 2026 at 17 stars.

Projects blowing up

How we call a verdict

Is this your project? Claim it

Figures by method 1.0