turbovault

TurboVault is a production-grade MCP server that transforms your Obsidian vault into an intelligent knowledge system powered by AI. It exposes a suite of 44 MCP tools for reading, writing, searching, analyzing, and managing notes, optimized for speed and reliability. The server is built in Rust and integrates with TurboMCP to provide type-safe tool definitions, standardized request/response envelopes, and transport options. You can run TurboVault with a static vault or add vaults at runtime, allowing Claude or other AI agents to interact with your vaults through the MCP interface and perform tasks such as full-text search, link graph analysis, health checks, batch edits, template-based note creation, and more. TurboVault is designed to be extended with additional tools as needed thanks to TurboMCP’s macro-driven approach.

Prerequisites:

• Rust toolchain (Rust 1.90+)
• Git
• Optional: cargo-install-enabled environment for ease of use

Install from crates.io (recommended for releases):

# Minimal install (STDIO only) - suitable for Claude Desktop
cargo install turbovault

# With HTTP server support
cargo install turbovault --features http

# With all transports (STDIO, HTTP, WebSocket, TCP, etc.)
# Note: May increase binary size
cargo install turbovault --features full

# Binary installed to: ~/.cargo/bin/turbovault

Alternatively, build from source:

git clone https://github.com/epistates/turbovault.git
cd turbovault
make release
# Binary: ./target/release/turbovault

Usage after installation (static vault example):

turbovault --vault /path/to/your/vault --profile production

To register a vault with Claude (runtime addition):

# Start server without vault
turbovault --profile production

Then connect a vault:

{
  "mcpServers": {
    "turbovault": {
      "command": "/path/to/turbovault",
      "args": ["--profile", "production"]
    }
  }
}

When connected, you can instruct Claude to add a vault at a path, search notes, or query the hub notes and related structures using the 44 available tools described in the README.

Tips and common considerations:

• TurboVault provides 44 MCP tools organized by category (File Operations, Link Analysis, Vault Health & Analysis, Full-Text Search, Templates).
• You can run the server with different transports enabled via Cargo features (STDIO, HTTP, WebSocket, TCP, Unix sockets).
• For production deployments, consider using the runtime vault addition workflow to add multiple vaults without restarting the server.
• If you plan to expose the MCP endpoint externally, secure the HTTP/WebSocket transports and consider enabling authentication middleware provided by TurboMCP.
• The README demonstrates practical examples for configuring Claude Desktop to connect to the TurboVault MCP server via the mcpServers JSON structure.