mi4uu

mi4uu / brain.md

Public

Local-first markdown notes with a first-class MCP server. 16 tools + 2 resources for Claude Code, Claude Desktop, Cursor and any MCP agent. Per-folder permissions, semantic RAG via LanceDB, single Bun binary. AGPL.

brainmd.lipinski.work agpl ai-agents bun claude-code claude-desktop
13
0
100% credibility
Found May 30, 2026 at 13 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

brain.md is a local-first note-taking application that combines a polished markdown editor with built-in AI capabilities. It stores notes as plain text files on your computer (Obsidian-compatible) and includes a semantic search engine that works fully offline using bundled AI technology. The app also acts as an MCP server, allowing AI assistants like Claude to read, search, and write your notes with per-folder access controls. Everything runs on your machine—no cloud services, no API keys required, and data never leaves your device.

How It Works

1
💡 You hear about brain.md

A friend tells you about a tool that keeps your notes private yet lets AI assistants help you search and organize them.

2
⚡ You install it in one line

A simple download command puts a single file on your computer—no extra software, no accounts, no waiting.

3
📝 You open your notes in a polished editor

The editor shows your text on one side and a beautiful preview on the other, with your existing Obsidian notes working instantly.

4
🔒 You protect sensitive folders

With a simple right-click, you lock down private folders so AI assistants can never see them—your secrets stay yours.

5
You connect an AI assistant
🔍
Ask your AI to find things

You ask 'what was I working on last week about project X?' and get answers from your notes, not the internet.

✍️
Have your AI write notes

Your AI creates or updates notes in your vault, saving them exactly where you want them.

6
🔄 Everything auto-saves to history

Every change automatically gets recorded in git history—you can see when you wrote something, restore old versions, and never lose work.

🎉 Your second brain is ready

You have a fast, private note system that AI can help with, everything stays on your computer, and your notes are plain text files you own forever.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 13 to 13 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is brain.md?

brain.md is a local-first markdown note-taking app that doubles as a memory layer for AI agents. You run it as a single Bun binary on your machine, open localhost:3000 in a browser, and get a polished editor with live preview supporting Obsidian-style wikilinks, callouts, math, and mermaid diagrams. The twist: it mounts a Model Context Protocol server on the same port, giving Claude Code, Cursor, or any MCP client 16 tools to read, search, and write your notes. Semantic search runs via a bundled WASM ONNX embedder (bge-small-en-v1.5) with no external dependencies. Every save auto-commits to git, and you can restrict which folders an agent can access via per-folder read/write permissions.

Why is it gaining traction?

The killer feature is the MCP server with built-in RAG. Other note apps either lack agent integration or require paid plugins. brain.md ships semantic search, per-folder permissions, and a full MCP tool surface in one binary that works fully offline. The comparison table makes a strong case: no Electron, no cloud dependency, no API keys. For developers building agentic workflows, this is a "give my AI access to my knowledge base" button with no plumbing required.

Who should use this?

Developers running Claude Code or Cursor who want their AI to reason over personal notes. Teams using MCP agents that need structured context beyond a single conversation window. Anyone who likes Obsidian's markdown dialect but wants a first-class agent API and per-folder access controls. Not for those who need a polished mobile app or plugin ecosystem.

Verdict

The feature set is impressive for a project at this stage, but the 1.0% credibility score and 13 stars tell the real story: this is early, experimental software. The documentation is thorough and the architecture is sound, but limited community feedback means rough edges are likely. Worth evaluating if you're building with MCP today; otherwise, watch the repo and let it mature.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.