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…

LLM Mart 0 views 90 listing impressions

A local-first second brain for you, and for your AI agents.

License: AGPL-3.0-or-later Runtime: Bun MCP: streamable-http RAG: WASM ONNX Glama MCP server

brain.md welcome

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.5 embedder by default running via bundled WASM ONNX. Switch to Ollama, LM Studio, OpenAI, or anything else with a /v1/embeddings endpoint 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.

Related servers

Universal MCP Server with advanced AI memory capabilities and semantic search.

30 views

MCP server for MikroTik routers: firewall, NAT, routing, DHCP, DNS, WireGuard and more via SSH.

28 views

Let Codex orchestrate external coding agents through their native harnesses.

28 views

Control plane MCP for scoped recon, triage, and bounded proofs.

27 views