Back to the catalog

NoteStore Lab MCP

Local copy-first Apple Notes recovery and review MCP server for NoteStore Lab case roots.

Open source Open in the app JSON README (API)

About

Local copy-first Apple Notes recovery and review MCP server for NoteStore Lab case roots.

Details

Kind
MCP servers
Topic
No topic detected
Publisher
xiaojiou176-open
Origin
official
Category
ferramentas
Transport
local
Version
0.1.0.post1
Stars
2
Open pull requests
6
Last push
2026-08-04T16:04:44Z
Repository state
ativo
Language
Python
License
MIT
Added
2026-08-29 04:01:42
Updated
2026-08-29 04:01:42
Origin id
io.github.xiaojiou176-open/notestorelab-mcp

README

<p align="center">
  <img src="https://em-content.zobj.net/source/apple/391/memo_1f4dd.png" width="120" alt="memo" />
</p>

<h1 align="center">notes-recover</h1>

<p align="center">
  <strong>your Apple Notes never really die</strong>
</p>

<p align="center">
  <a href="https://github.com/xiaojiou176-open/notes-recover/stargazers"><img src="https://img.shields.io/github/stars/xiaojiou176-open/notes-recover?style=flat&color=yellow" alt="Stars"></a>
  <a href="https://github.com/xiaojiou176-open/notes-recover/commits/main"><img src="https://img.shields.io/github/last-commit/xiaojiou176-open/notes-recover?style=flat" alt="Last Commit"></a>
  <a href="LICENSE"><img src="https://img.shields.io/github/license/xiaojiou176-open/notes-recover?style=flat" alt="License"></a>
</p>

<p align="center">
  <a href="#what-you-get">What You Get</a> •
  <a href="#install">Install</a> •
  <a href="#how-it-work">How It Work</a> •
  <a href="#ecosystem">Ecosystem</a>
</p>

---

notes-recover is a forensic-grade reader for Apple Notes. Recover deleted notes, browse the raw NoteStore, and ship audit-ready bundles. Nothing leaves your machine.

> 🤝 **Sister repo**: want a *prevention*-side workflow that schedules backups before notes go missing? See [**notebackup**](https://github.com/xiaojiou176-open/notebackup) — the Apple Notes backup control room (path-aware exports, `launchd` scheduling, health checks). `notebackup` covers the *before*; `notes-recover` covers the *after*. Together they cover the full Apple Notes lifecycle on macOS.

```
┌──────────────────────────────────────┐
│  LOCAL-FIRST          ████████ 100%  │
│  SOURCE-TRACEABLE     ████████ 100%  │
│  TYPING REQUIRED      ░░░░░░░░   0%  │
│  VIBES                ████████ ZERO  │
│                                FILLER│
└──────────────────────────────────────┘
```

> Recover, browse, prove. NoteStore is just SQLite if you know where to look.

## What You Get

| Surface | What |
|---|---|
| `notes-recovery cli` | Walk NoteStore.sqlite. Recover trashed and orphan notes. |
| `case review skill` | Bounded Q&A over a single case root, no hallucinations. |
| `agent plugins` | Drop-in for Claude, Codex, OpenClaw — case in, summary out. |
| `proof bundle` | Every claim ships with the path, hash, and snippet. |

> [!IMPORTANT]
> Local-first by default. No silent telemetry. No cloud round-trip. Your data stays on your machine until you explicitly ship it somewhere.

## Install

```bash
git clone https://github.com/xiaojiou176-open/notes-recover.git
cd notes-recover
# follow the per-stack quickstart in INSTALL.md or docs/
```

Three commands. No `curl | sh`. No login. Read what you run.

Install break? Open your favorite agent and say *"Read AGENTS.md and bootstrap notes-recover for me."* Agent fix own brain. Long version: [`docs/`](./docs/).

## How It Work

The repo is seven layers — exactly the seven commits in `git log`. New work goes in as small named PRs. No 50-file mystery commits.

| Layer | What |
|---|---|
| `chore: scaffold` | License, governance, hygiene gates, CI scaffolding. |
| `feat(core)` | The primary engine. The reason notes-recover exists. |
| `feat(modules)` | Packages, adapters, services, plugins. The second floor. |
| `feat(contracts)` | Schemas, configs, public boundaries. Other code talks here. |
| `test:` | Receipts. Everything in this layer must run. |
| `feat(ops)` | Scripts, infra, CI helpers, build glue. |
| `docs:` | Public docs surface. The pretty face. |

`git log` reads like a building floor plan. Look once, know the whole shape.

## Ecosystem

notes-recover lives in the **yard family**: seven yards. one philosophy: structured input, structured output, structured proof.

| Repo | What |
|---|---|
| [**switchyard**](https://github.com/xiaojiou176-open/switchyard) | model & agent runtime switch board |
| [**browserclickyard**](https://github.com/xiaojiou176-open/browserclickyard) | your AI clicks, your browser obeys |
| [**notes-recover**](https://github.com/xiaojiou176-open/notes-recover) *(you here)* | your Apple Notes never really die |
| [**dealyard**](https://github.com/xiaojiou176-open/dealyard) | let prices fight, you sit and watch |
| [**docyard**](https://github.com/xiaojiou176-open/docyard) | docs site in, markdown out, no scraping by hand |
| [**fileyard**](https://github.com/xiaojiou176-open/fileyard) | messy folders in, organized library out |
| [**proofyard**](https://github.com/xiaojiou176-open/proofyard) | every claim ships with its receipt |

Cross-family taste:
[**BeamMe**](https://github.com/xiaojiou176-open/BeamMe) ·
[**BrewMe**](https://github.com/xiaojiou176-open/BrewMe) ·
[**OpenVibeCoding**](https://github.com/xiaojiou176-open/OpenVibeCoding) ·
[**proofyard**](https://github.com/xiaojiou176-open/proofyard).

## Star This Repo

If notes-recover saves you a click, an hour, or a headache — star costs zero. Fair trade. ⭐

[![Star History Chart](https://api.star-history.com/svg?repos=xiaojiou176-open/notes-recover&type=Date)](https://star-history.com/#xiaojiou176-open/notes-recover&Date)

## Also by Yifeng[Terry] Yu

- **[switchyard](https://github.com/xiaojiou176-open/switchyard)** — model & agent runtime switch board
- **[browserclickyard](https://github.com/xiaojiou176-open/browserclickyard)** — your AI clicks, your browser obeys
- **[BeamMe](https://github.com/xiaojiou176-open/BeamMe)** — beam your agent config to any planet
- **[BrewMe](https://github.com/xiaojiou176-open/BrewMe)** — wake up, news already brewed
- **[OpenVibeCoding](https://github.com/xiaojiou176-open/OpenVibeCoding)** — AI codes overnight, you ship in the morning

## License

MIT — small print, big freedom.

More