Brain.Md

Name: Brain.Md
Author: mi4uu

by mi4uu

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.

32 7 tools GitHub

No known CVEs

AGPL-3.0 license

Actively maintained

Last commit 9d ago

Works with most clients

Transport: stdio, sse, http

7 tools · ~226 tok

Grade A · 0.1% of 200K ctx

MCPpedia last refreshed this data 2h ago

Edit this pageView history

Brain.Md is an MCP server that 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. Its tool list has not been published yet over stdio, sse and http, requires no API key, and scores 70/100 on MCPpedia's security, maintenance and efficiency rubric.

AI / ML Writing

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, sse, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "brain.md": {
      "url": "http://localhost:3000/mcp",
      "type": "streamable-http"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/brain-md)](https://mcppedia.org/s/brain-md)

Read me

What Brain.Md does

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

Test This Server

This server supports HTTP transport. Be the first to test it — help the community know if it works.

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

70/100across 5 weighted dimensions

How we score →

0255075100

−30

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

No package registry to scan.

Inventory

Tools (7)

Click any tool to inspect its schema.

~226 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Brain.Md safe to use?: Brain.Md has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under AGPL-3.0.
How do I install Brain.Md?: Brain.Md supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can Brain.Md do?: Brain.Md provides 7 tools: Note, Backend, Frontend, Embedder, WebStandardStreamableHTTPServerTransport and 2 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Brain.Md?: Brain.Md is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.
Is Brain.Md actively maintained?: Brain.Md is actively maintained — last commit was 9 days ago. It has 32 GitHub stars.

Similar servers

Others in ai-ml / writing

View all →

Dsh MCP Client97

MCP client bridge: connects to MCP servers and registers their tools on ctx.tools

196.2k 4

Gpt Researcher97

An autonomous agent that conducts deep research on any data using any LLM providers

29.2k 5

Modelcontextprotocol96

The official MCP server implementation for the Perplexity API Platform

2.5k 4

Antigravity Workspace Template96

Workspace template + MCP server for Claude Code, Codex CLI, Cursor & Windsurf. Multi-agent knowledge engine (ag-refresh / ag-ask) that turns any codebase into a queryable AI assistant.

1.3k 2

MCP Security Weekly

Get CVE alerts and security updates for Brain.Md and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?


📝 Obsidian-compatible markdown	Wikilinks, embeds, callouts, math, mermaid, tasks, frontmatter, aliases. Open your existing Obsidian vault — 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, OpenAI — anything with `/v1/embeddings`.
🛰️ MCP server (streamable HTTP)	17 tools + 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	Every save lands in git. 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.

📝 Obsidian-compatible markdown

Wikilinks, embeds, callouts, math, mermaid, tasks, frontmatter, aliases. Open your existing Obsidian vault — 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, OpenAI — anything with /v1/embeddings.

🛰️ MCP server (streamable HTTP)

17 tools + 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

Every save lands in git. 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 and git autocommit / restore 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

Frequently Asked Questions

Is Brain.Md safe to use?

Brain.Md has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under AGPL-3.0.

How do I install Brain.Md?

Brain.Md supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can Brain.Md do?

Brain.Md provides 7 tools: Note, Backend, Frontend, Embedder, WebStandardStreamableHTTPServerTransport and 2 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with Brain.Md?

Brain.Md is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.

Is Brain.Md actively maintained?

Brain.Md is actively maintained — last commit was 9 days ago. It has 32 GitHub stars.


📝 Obsidian-compatible markdown	Wikilinks, embeds, callouts, math, mermaid, tasks, frontmatter, aliases. Open your existing Obsidian vault — 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, OpenAI — anything with `/v1/embeddings`.
🛰️ MCP server (streamable HTTP)	17 tools + 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	Every save lands in git. 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.

📝 Obsidian-compatible markdown

Wikilinks, embeds, callouts, math, mermaid, tasks, frontmatter, aliases. Open your existing Obsidian vault — 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

🛰️ MCP server (streamable HTTP)

17 tools + 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

Every save lands in git. 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

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),

optional password auth and git autocommit / restore 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

Brain.Md

Install in your client