obsidian-rag-mcp
Provides RAG-based search over an Obsidian vault, allowing AI agents to retrieve and answer questions from notes with source citations.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@obsidian-rag-mcp search my notes for information on the CIA triad"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
rag-obsidian-lmstudio
Fully local RAG over an Obsidian (or any markdown) vault, powered by LM Studio. Nothing leaves your machine.
Two ways to use it:
obsidian-rag— a terminal REPL: ask questions, get answers grounded in your notes with source citations.obsidian-rag-mcp— an MCP server for the LM Studio GUI: the chat model gets asearch_notestool and answers from your vault, inside the app.
Indexing is incremental: only new or edited files are re-embedded on each run.
Prerequisites
LM Studio with the local server running (Developer tab → Start Server, default
http://localhost:1234).Two models loaded:
a chat model (e.g. any Gemma / Llama / Qwen instruct model)
an embedding model (e.g.
nomic-embed-text-v1.5)
Python ≥ 3.11 and
uv(orpipx).
Related MCP server: obsidian-local-mcp
Install
uv tool install git+https://github.com/shirokoweb/rag-obsidian-lmstudio
# or: pipx install git+https://github.com/shirokoweb/rag-obsidian-lmstudioUse the terminal REPL
obsidian-rag --docs-dir ~/path/to/your/vaultChat: google/gemma-4-e4b
Embed: text-embedding-nomic-embed-text-v1.5
Indexed 317 chunks from /Users/you/vault
Ask a question (blank line or Ctrl-D to quit).
? What is the CIA triad?
The CIA triad is a model that helps organizations consider risk ...
sources: Module 2/25. Explore the CIA triad.md, ...
top score: 0.830Use inside LM Studio (MCP)
Add the server to LM Studio's mcp.json (Program tab → Install →
Edit mcp.json):
{
"mcpServers": {
"obsidian-rag": {
"command": "obsidian-rag-mcp",
"env": {
"RAG_DOCS_DIR": "/Users/you/path/to/your/vault"
}
}
}
}Then ask the chat model anything about your notes — it calls search_notes
and answers grounded, with source filenames.
If LM Studio can't find the command, use the absolute path (
which obsidian-rag-mcp) in thecommandfield.
Configuration
CLI flags take precedence over environment variables.
Flag | Env var | Default | Purpose |
|
| (required) | Vault / notes directory |
|
|
| LM Studio server URL |
|
| auto-detect | Chat model id |
|
| auto-detect | Embedding model id |
|
|
| Retrieved chunks per question (1–20) |
Auto-detection picks the first loaded model whose id contains embed as the
embedder and the first other model for chat. With several chat models loaded,
set RAG_CHAT_MODEL explicitly.
The embedding cache lives in your OS user-cache directory (e.g.
~/Library/Caches/rag-obsidian-lmstudio on macOS) — never inside your vault.
Deleting it is always safe; it will be rebuilt.
Troubleshooting
Symptom | Fix |
| Start the server: LM Studio → Developer tab → Start Server |
| Load an embedding model and a chat model in LM Studio |
| The chat model is too large/slow — set |
| Pass |
Stale answers after editing notes | Nothing to do — the index refreshes on every run/query |
Privacy & security notes
All traffic goes to your configured LM Studio URL (localhost by default); there are no other network calls, no telemetry.
The cache uses plain JSON + NumPy
.npz— no pickle, nothing executable.The tool only ever reads your vault; it never writes into it.
Development
git clone https://github.com/shirokoweb/rag-obsidian-lmstudio
cd rag-obsidian-lmstudio
uv sync --all-extras
uv run pytest # tests
uv run ruff check . && uv run ruff format --check .
uv run mypy src # typecheckSee SPEC.md for design decisions. MIT license.
Available Tools
1 toolsearch_notesA
Search the user's markdown notes for passages relevant to the query. Use this for any question about the user's notes, then answer using only the returned passages and cite their source filenames.
Args: query: A natural-language question or topic to search for. top_k: How many passages to return (default 4, max 20).
Inputs: query (required), top_k. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion between tools. The single tool's purpose is clear and distinct.
The tool name 'search_notes' follows a clear verb_noun pattern. As the only tool, it is internally consistent.
A single tool is borderline. It is not trivial and serves the core purpose of searching notes, but the tool surface feels thin for a server intended to support RAG over an entire note collection.
The search tool covers the primary retrieval need. Minor gaps exist, such as no ability to list all notes or fetch a specific note directly, but these can be worked around by searching with broad queries.
Related MCP Connectors
Hosted MCP server for Obsidian Sync vaults: read, search, edit notes. Not affiliated with Obsidian.
Serve a folder of Markdown notes as an MCP server: hybrid search, reading, and sourced answers.
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceA local MCP server that enables AI applications like Claude Desktop to securely access and work with Obsidian vaults, providing capabilities for reading notes, executing templates, and performing semantic searches.831MIT
- AlicenseNot gradedqualityDmaintenanceA local MCP server that wraps the Obsidian CLI to give AI assistants direct access to read, edit, and manage notes within an Obsidian vault. It enables advanced operations such as frontmatter property management, context-aware searching, and the execution of internal Obsidian commands.2MIT
- AlicenseNot gradedqualityBmaintenanceAn Obsidian plugin that runs an MCP server, enabling external LLM tools to read, search, create, and modify notes in your vault via HTTP or stdio transport.44MIT
- FlicenseNot gradedqualityDmaintenanceMCP server that provides natural language access to an Obsidian vault, enabling reading, searching, listing, and creating notes.-