Wandering RAG

@wandermyz

About Wandering RAG

A CLI tool for personal RAG that retrieves data from Notion, Obsidian, Apple Notes, etc., stored in Qdrant and exposed as an MCP server.

#mcp #obsidian #rag

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "wandering-rag": {
      "command": "uv",
      "args": [
        "pip",
        "install",
        "-e",
        "."
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Wandering RAG?

A CLI tool for personal RAG that retrieves data from Notion, Obsidian, Apple Notes, and other sources, stores it in Qdrant, and exposes it as an MCP server (e.g., for use with Claude Desktop).

How to use Wandering RAG?

Install with uv pip install -e ., run a Qdrant server using the provided Docker Compose file, copy .env.example to .env, and specify your Markdown folders or Obsidian vaults. Use the CLI subcommands: wandering-rag md index for Markdown, wandering-rag notion index (work in progress), and wandering-rag mcp run-server to start the MCP server. Configure Claude Desktop by adding the server to its MCP configuration JSON.

Key features of Wandering RAG

CLI‑based personal RAG system
Indexes Markdown from folders or Obsidian vaults
Notion indexing (work in progress)
Stores indexed data in Qdrant vector database
Exposes a Model Context Protocol (MCP) server

Use cases of Wandering RAG

Query personal notes (e.g., “When did I adopt my cat?”) through Claude Desktop
Combine data from Obsidian, Markdown, and Notion in a single retrieval pipeline
Run a local, self‑hosted RAG system without external cloud dependencies

FAQ from Wandering RAG

What dependencies are required?

You need a running Qdrant server (a Docker Compose file is provided) and a .env file with your configuration (e.g., Markdown folder paths).

How do I configure Wandering RAG for Claude Desktop?

Add an entry to the mcpServers object in Claude Desktop’s config, pointing the command to your checkout’s wandering-rag script with arguments ["mcp", "run-server"] and setting the PATH environment variable to include ~/.local/bin.

Is Notion indexing fully supported?

Notion commands are listed as “WIP” (work in progress); only notion index is available, and its maturity is not stated.

Where is the indexed data stored?

Data is stored in Qdrant, a vector database that runs locally via Docker.

What file formats can be indexed?

The README explicitly shows support for Markdown files (via md index) and mentions Obsidian vaults (which are Markdown‑based). No other formats are confirmed as working.

Frequently asked questions

What dependencies are required?

You need a running Qdrant server (a Docker Compose file is provided) and a `.env` file with your configuration (e.g., Markdown folder paths).

How do I configure Wandering RAG for Claude Desktop?

Add an entry to the `mcpServers` object in Claude Desktop’s config, pointing the `command` to your checkout’s `wandering-rag` script with arguments `["mcp", "run-server"]` and setting the `PATH` environment variable to include `~/.local/bin`.

Is Notion indexing fully supported?

Notion commands are listed as “WIP” (work in progress); only `notion index` is available, and its maturity is not stated.

Where is the indexed data stored?

Data is stored in Qdrant, a vector database that runs locally via Docker.

What file formats can be indexed?

The README explicitly shows support for Markdown files (via `md index`) and mentions Obsidian vaults (which are Markdown‑based). No other formats are confirmed as working.

Comments

Basic information

More Memory & Knowledge MCP servers

RAG Documentation MCP Server

hannesrudolph

An MCP server implementation that provides tools for retrieving and processing documentation through vector search, enabling AI assistants to augment their responses with relevant documentation context.

267

Rust Docs MCP Server

Govcraft

🦀 Prevents outdated Rust code suggestions from AI assistants. This MCP server fetches current crate docs, uses embeddings/LLMs, and provides accurate context via a tool call.

286