Wandering RAG

By wandermyz GitHub

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

Overview

what is Wandering RAG?

Wandering RAG is a command-line interface (CLI) tool designed for personal retrieval-augmented generation (RAG) that fetches data from various sources like Notion, Obsidian, and Apple Notes, storing it in Qdrant and exposing it as a MCP server.

how to use Wandering RAG?

To use Wandering RAG, install it using pip, run a Qdrant server, and configure the necessary Markdown folders or Obsidian vaults. You can then execute various commands through the CLI to index and retrieve your data.

key features of Wandering RAG?

Retrieves data from multiple note-taking applications.
Exposes data as an MCP server for easy access.
Supports indexing commands for Markdown and Notion.

use cases of Wandering RAG?

Retrieving personal notes from Obsidian for quick access.
Integrating with Claude Desktop to answer specific queries about personal data.
Managing and indexing notes from various platforms in one place.

FAQ from Wandering RAG?

What platforms does Wandering RAG support?

Wandering RAG supports Notion, Obsidian, and Apple Notes.

Is there a graphical user interface?

No, Wandering RAG is a CLI tool and does not have a graphical user interface.

How do I install Wandering RAG?

You can install it using the command uv pip install -e . after setting up your environment.

Content

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.

(So that Claude Desktop successfully answers my question "When did I adopt my cat and when did I change her cat litter most recently? ")

Installation

Using uv (recommended):

uv pip install -e .

Run a Qdrant server if you don't have one:

cd qdrant-docker
docker-compose up -d

Copy .env.example as .env and specify the Markdown folders (or Obsidian vaults)

Usage

The CLI provides several subcommands:

Markdown commands

./wandering-rag md index

Notion commands (WIP)

./wandering-rag notion index

MCP commands

./wandering-rag mcp run-server

Configure for Claude Desktop

{
    "mcpServers": {
        "wandering-rag": {
            "command": "<your git checkout path>/wandering-rag/wandering-rag",
            "args": ["mcp", "run-server"],
            "env": {
                "PATH": "<your home folder>/.local/bin:/usr/bin:$PATH"
            }
        }
    }
}