Brain.md
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 permissio…
A local-first second brain for you, and for your AI agents.

What you get
| 📝 Obsidian-compatible markdown | Wikilinks, embeds, callouts, math, mermaid, tasks, frontmatter, aliases. Open your existing Obsidian vault and it just works. |
| ⚡ Live editor + preview | CodeMirror 6 with cursor-anchored scroll sync, autosave, instant tooltips, command palette, quick switcher. |
| 🔍 Semantic search built in | Per-vault embedded vector store (pure JS, no external DB). Notes are chunked, embedded and indexed on every save. |
| 🤖 Pluggable embedders | Default: bge-small-en-v1.5 running locally via bundled WASM ONNX, works in the prebuilt single binary, zero native deps. Or point at Ollama, LM Studio, or OpenAI: anything with /v1/embeddings. |
| 🛰️ MCP server (streamable HTTP) | 17 tools and 2 resources mounted on the same port. Claude Desktop, Claude Code, Cursor and any MCP-compliant agent can read, search, query and write your notes. |
| 🔒 Per-folder agent permissions | Right-click a folder → set {read, write} for the MCP surface. Keep Journal/Private/ out of agent reach without locking down the vault. |
| 🔑 Optional password auth | argon2id, bearer tokens, 24-hour TTL, gates both HTTP API and MCP. Off by default, on with one click. |
| 📜 Git autocommit with a full audit trail | Every save lands in git, attributed to whoever (or whichever agent) made it. Full history, diff, restore, manual checkpoints. The vault is a real git repo on disk. |
| 🌍 No vendor lock-in | Your vault is a folder of .md files. Open it in VSCode, Obsidian, cat, anything. brain.md is just one more way to view and query it. |
| 💸 Zero API keys required | Out of the box it runs fully offline. Cloud embedders are an opt-in, not a default. |
Why brain.md
LLMs are only as smart as the context you give them. brain.md turns your notes into that context, without dragging them into someone else's cloud, without locking them inside a proprietary format, and without asking you to plumb a vector database yourself.
You write markdown. brain.md gives you:
- a polished editor + live preview with the full Obsidian-flavor dialect (wikilinks, embeds, callouts, math, mermaid, highlights, tasks, frontmatter, aliases),
- a per-vault embedded vector store (pure JS, ships in the single
binary) with a local
bge-small-en-v1.5embedder by default running via bundled WASM ONNX. Switch to Ollama, LM Studio, OpenAI, or anything else with a/v1/embeddingsendpoint with one toggle, - an MCP server (streamable HTTP) mounted on the same port, so Claude Desktop (or any MCP client) can read, search and write your notes safely, with per-folder read/write permissions for the agent surface,
- optional password auth (or login via Google, GitHub, Keycloak or Authentik) and git autocommit / restore with a per-path audit trail for the whole vault.
Everything runs on your machine. The vault is a plain folder of .md
files you can open in any editor at any time.
How it compares
From the project's README.