← Back to blog

Dev Setup

Obsidian as the brain of Claude

A Markdown vault becomes persistent memory — shared between Claude Desktop and Claude Code, versioned through Git, under compliance control.

Chat context is ephemeral. A vault isn’t.

Unlike chat memory, an Obsidian vault is persistent, portable, versioned and yours — usable across machines and clients. The vault is the memory; Claude is the thinking and writing layer. Three functions keep the system alive: search the vault before any task (read), persist findings as atomic notes (write), and audit orphans and dead links regularly (maintain).

Two paths, one vault

  • Claude Desktop has no native filesystem access → the bridge is a local MCP server (stdio), configured in claude_desktop_config.json.
  • Claude Code reads and writes the vault natively as a directory. It’s steered through CLAUDE.md plus skills in .claude/skills/, versioned via Git.

Run both in parallel — the same Git vault — and you get one brain with two entrances: Code for autonomous maintenance and team discipline, Desktop as a comfortable reading front end.

Read the full guide

Members get the complete architecture guide: both setup paths step by step, the assessed skills and MCP-server table (licence, compliance, additive-only), the maintenance cycle and the multi-machine topology for teams — plus the GDPR / BSI C5 / EU AI Act reality check.

Read the full guide — free sign-up

MEMBER · FREE

Read the full article — sign up free

The full article is member content. Magic-link login, no credit card, no risk — and the rest of the article is readable immediately.