Obsidian Semantic Search
Semantic search across your Obsidian vaults using local embeddings (Ollama + pgvector). 10 MCP tools: hybrid/semantic/keyword search, file CRUD, batch reads, live re-indexing, and a monitoring dashboard. Fully local — no API keys, no cloud, zero cost.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/celstnblacc/obsidian-semantic-searchObsidian Semantic Search
Search your Obsidian vault by meaning, not just keywords. This skill installs and configures obsidian-semantic-mcp — a local-first MCP server that indexes your vault with vector embeddings (Ollama + pgvector) and exposes 10 tools to any MCP-compatible AI assistant.
What You Get
10 MCP Tools
| Tool | What it does |
|---|---|
search_vault | Semantic, keyword, or hybrid search with similarity scores |
simple_search | Fast exact-text search across all files |
list_files | Browse vault directories |
get_file | Read a single file |
get_files_batch | Read multiple files in one call |
append_content | Append text to a file (creates if missing) |
write_file | Overwrite a file completely |
recent_changes | List recently modified files |
list_indexed_notes | See all indexed notes with timestamps |
reindex_vault | Force a full re-index |
Monitoring Dashboard (port 8484)
- Real-time service health (PostgreSQL, Ollama, embedding model)
- Indexed notes count, vault coverage %, database size
- Search testing UI — test queries without leaving your browser
- Manual re-index trigger
Search Modes
- Hybrid (default): Combines semantic meaning + keyword matching for best results
- Semantic: Search by meaning only — finds related content even with different wording
- Keyword: Exact text matching via PostgreSQL full-text search
Installation
Prerequisites
- Docker Desktop (running)
- uv (Python package manager):
curl -LsSf https://astral.sh/uv/install.sh | sh - An Obsidian vault on your local filesystem
One-Liner Install
bash <(curl -fsSL https://raw.githubusercontent.com/celstnblacc/obsidian-semantic-mcp/main/install.sh) --mode 2 --vault /path/to/your/vault
This clones the repo to ~/.local/share/obsidian-semantic-mcp, installs the osm CLI, and runs the setup wizard in Docker mode.
Manual Install
git clone https://github.com/celstnblacc/obsidian-semantic-mcp.git
cd obsidian-semantic-mcp
uv sync
uv run osm init
The wizard detects your OS and offers setup modes:
macOS (4 modes):
- Mode 1: Native (Homebrew — no Docker needed)
- Mode 2: Docker + host Ollama (if Ollama already installed)
- Mode 3: Full Docker (recommended — everything in containers)
- Mode 4: Docker + remote Ollama (SSH tunnel to a GPU server)
Linux (3 modes):
- Mode 1: Docker + host Ollama
- Mode 2: Full Docker (recommended)
- Mode 3: Docker + remote Ollama
Verify Installation
osm status
Should show: Docker containers running, Ollama healthy, embedding model loaded, vault indexed.
Register with Claude Desktop
The wizard auto-configures this, but if you need to do it manually:
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-celstnblacc-obsidian-semantic-search": {
"enabled": true,
"auto_update": true
}
}
}Related Skills
Git Security Scanner
Unified security scanner that catches leaked secrets, credentials, and code vulnerabilities before they reach your remote. Wraps gitleaks (400+ secret patterns) and shipguard (48+ SAST rules) into a single tool with pre-commit hooks, on-demand scans, and full git history audits.
YouTube Model Feeder
Food for your model — extract transcripts, key frames, OCR, slides, and LLM summaries from YouTube videos into structured AI-ready knowledge.