obsidian-rag
Provides semantic search over an Obsidian vault, enabling query-by-meaning across markdown notes.
Click on "Install 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-ragfind notes about project architecture"
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.
Obsidian RAG — Semantic Note Search
Local semantic search for your Obsidian vault, powered by BAAI/bge-m3 embeddings and ChromaDB.
Features
Semantic search — find notes by meaning, not just keywords
Markdown-aware chunking — splits by heading hierarchy for better context
Apple Silicon acceleration — MPS support for M-series Macs
Multiple interfaces — CLI, REST API, and MCP server (for Claude/Cursor)
Multilingual — full Chinese-English support via bge-m3
Related MCP server: Obsidian RAG MCP Server
Quick Start
# Install
pip install -e .
# Index your vault
export OBSIDIAN_VAULT_PATH="/path/to/your/vault"
python -m obsidian_rag index "$OBSIDIAN_VAULT_PATH" --full
# Search
python -m obsidian_rag search "your question"
# Start API server (for web UI or integrations)
python -m obsidian_rag apiArchitecture
Obsidian vault (.md files)
→ chunker.py: split by Markdown headings
→ embeddings.py: BAAI/bge-m3 (MPS accelerated)
→ ChromaDB: cosine similarity vector store
→ Interfaces:
├── CLI: python -m obsidian_rag search "query"
├── REST API: FastAPI on :8787
└── MCP: Claude Code / Cursor integrationTech Stack
Component | Choice |
Embedding model | BAAI/bge-m3 (1024d, multilingual) |
Vector DB | ChromaDB (local, cosine space) |
API | FastAPI + Uvicorn |
AI integration | MCP (Model Context Protocol) |
MCP Configuration
For Claude Code (.mcp.json):
{
"mcpServers": {
"obsidian-rag": {
"command": "python",
"args": ["-m", "obsidian_rag.server"],
"env": {
"OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
}
}
}
}This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/asiansumer/obsidian-rag'
If you have feedback or need assistance with the MCP directory API, please join our Discord server