Stellavault MCP Server

Local-first MCP server: Claude searches, asks & drafts from your Obsidian vault. 21 tools, no keys.

Local serverstdioTypeScript

What is the Stellavault MCP server?

Stellavault MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. Local-first MCP server: Claude searches, asks & drafts from your Obsidian vault. 21 tools, no keys.

What you get

Karpathy's self-compiling wiki × Zettelkasten — fully local, vault-safe, and MCP-native.

  • 🧠 It compiles itself. Drop in a PDF, a YouTube link, or a half-formed thought — Stellavault extracts it to raw/, then compiles a clean _wiki/ with concepts and backlinks. Knowledge that organizes itself as it grows
  • 🌌 Your mind, in 3D. A real-time neural graph (React Three Fiber) — cluster coloring, constellations, heatmaps, a timeline, and a multiverse P2P view. A way to see the shape of what you know
  • 🤖 Claude reads your entire vault. A first-class MCP server (21 tools): Claude can search, ask, draft, lint, and analyze your knowledge from Claude Code, Claude Desktop, Cursor, Windsurf, or VS Code
  • It never silently forgets. FSRS memory decay surfaces the real notes you're about to lose — plus gap, contradiction, and duplicate detection across the whole vault
  • 🔒 Local-first. Vault-safe. Zero keys. Local embeddings, an on-device vector store, and your original files are never modified. Nothing leaves your machine unless you opt in

Setting it up

Installation goes through your MCP client rather than a global install: point it at stellavault on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

Configuration and credentials

You will need 2 environment variables: STELLAVAULT_FEDERATION_EXPERIMENTAL, STELLAVAULT_DB_PATH. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the stellavault mcp server does with a few real requests.

Choosing this one

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. It is maintained by Evanciel; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Stellavault's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

How to install the Stellavault MCP server

{
  "mcpServers": {
    "stellavault": {
      "command": "npx",
      "args": ["-y", "stellavault"],
      "env": {
        "STELLAVAULT_FEDERATION_EXPERIMENTAL": "your-value",
        "STELLAVAULT_DB_PATH": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
STELLAVAULT_FEDERATION_EXPERIMENTALConfiguration value read at startup.Optional
STELLAVAULT_DB_PATHFilesystem location the server is allowed to use.Optional

Frequently asked questions

It connects Stellavault to MCP-compatible AI assistants such as Claude and Cursor. Instead of copying data back and forth by hand, the assistant works with Stellavault directly.