Skip to content

Vault Search

Hybrid (lexical + dense) semantic search over your indexed vault(s) — notes and repos chunked at heading level, running natively in work-buddy (not Obsidian / Smart Connections). Returns ranked chunk excerpts with bm25 and dense scores. Served warm from the embedding service's resident matrix; degrades to lexical-only (FTS5) if the embedding service is down.

MCP name: vault_search

Category: context

Parameters

Name Type Required Description
method str No Retrieval method: 'hybrid' (default), 'lexical' (FTS5 only), or 'dense' (vectors only).
query str Yes Natural-language search query.
recency bool No Apply a recency bias to ranking (default false).
top_k int No Max results to return (default 10).
vault_id str No Restrict to a single vault by its configured id (optional; omit to search all).

Details

Native chunk-level semantic search over the vault semantic index. Pairs with vault_index (build/status). Use vault_search to retrieve relevant note/repo passages; use vault_index action=status to see what is and isn't indexed.