Obsidian Brain MCP Server

A standalone Node MCP server that gives Claude (and any other MCP client) semantic search + knowledge graph + vault editing over an Obsidian vault. Runs as one local stdio process - no plugin, no HTTP bridge, no API key, nothing hosted. Your vault content never leaves your machine.

People connecting productivity tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-12 · ★ 10 · #47 OF 139 MAINTAINED PRODUCTIVITY · VERIFIED 2026-08-25

Apache-2.0 · TypeScript servers · how we verify → /methodology

01 · Install Obsidian Brain

before you install - you'll need

VAULT_PATH

Environment variables documented in the project's README - it lists which are required and which have defaults.

Claude Code

claude mcp add sweir1-obsidian-brain -- npx -y obsidian-brain

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "sweir1-obsidian-brain": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-brain"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license Apache-2.0 - declared in the repository

npm package obsidian-brain - unscoped; check the name against the project README before installing

registry namespace io.github.sweir1 is GitHub-verified and matches the repo owner

03 · What Obsidian Brain can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v1.7.24 · 2026-05-16

v1.7.24 - 2026-05-16 - embeddings.md BYOM callout + 5 devDep bumps · Polish release. No code behavior changes. · docs/embeddings.md now includes an "Auto-pull on first boot" admonition next to the Ollama setup snippet…

v1.7.23 · 2026-05-16

v1.7.23 - 2026-05-16 - BYOM Ollama auto-pull gate + logger sweep + SIGTERM unit test · Closes three follow-ups from the v1.7.22 audit cycle: a BYOM-aware auto-pull gate so users supplying…

v1.7.22 · 2026-05-15

v1.7.22 - 2026-05-15 - structured stderr (NDJSON) + Ollama preparing-state + dependabot security bumps + SIGTERM drain integration test · Bundles the four structural follow-ups deferred from v1.7.21 (V4, O3/N2, L1, O7…

04 · Who maintains Obsidian Brain

Obsidian Brain is maintained by sweir1. It's the only MCP server we track from this author; the repo dates to Apr 2026.

05 · Facts

repository: github.com/sweir1/obsidian-brain
website: https://sweir1.github.io/obsidian-brain/
category: productivity - ranked #47 of 139 actively-maintained productivity servers as of 2026-08-25.
registry: io.github.sweir1/obsidian-brain (active, first published 2026-04-22 · 53 versions)
packages: npm:obsidian-brain

06 · Obsidian Brain FAQ

What is Obsidian Brain?

Is Obsidian Brain still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-12. We re-verify nightly.

How do I install Obsidian Brain?

Run `npx -y obsidian-brain`. The README documents one environment variable (VAULT_PATH) to set first. You can also paste the ready-made client config above.

Does Obsidian Brain run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Obsidian Brain

Alternatives to Obsidian Brain

Maintained productivity servers if Obsidian Brain isn't the fit.

Pairs well with

Servers that cover what Obsidian Brain doesn't - only shown when the pairing reason fits the companion.

More productivity MCP servers · TaskTime Pro · Cosmos MCP · Temporal Cortex Calendar MCP · Mneme (thegoatpsy) · NeuroDock Task Fractionator

More TypeScript MCP servers · Mistral MCP · CloakBrowser MCP · Koma Core MCP · Koma Gate MCP · Image Reader MCP · see all