← Index

Obsidian Semantic Search

io.github.DalecB/obsidian-semantic-mcp·v0.1.1·Search
Quality Score
85
/100

Read-only semantic search MCP server for Obsidian vaults using local Ollama embeddings.

§00  Trust verdict · v1 advisory ·  method
UNVERIFIEDno verdict on file

Verdict not yet evaluated for this tool. The hybrid eval runs adversarial cases first; coverage rolls out as the corpus expands. Until a verdict is recorded, an agent should treat this tool as not-yet-cleared and fall back to its own checks. Method: hybrid eval, four-state verdict, honest limits.

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "obsidian-semantic-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dalecb/obsidian-semantic-mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_ROOT": "<obsidian_vault_root>",
        "OBSIDIAN_SEMANTIC_MCP_HOME": "<obsidian_semantic_mcp_home>",
        "OBSIDIAN_EMBED_MODEL": "<obsidian_embed_model>",
        "OLLAMA_BASE_URL": "<ollama_base_url>",
        "OBSIDIAN_SEMANTIC_STARTUP_INDEX": "<obsidian_semantic_startup_index>",
        "OBSIDIAN_SEMANTIC_ALLOW_SENSITIVE": "<obsidian_semantic_allow_sensitive>"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "obsidian-semantic-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dalecb/obsidian-semantic-mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_ROOT": "<obsidian_vault_root>",
        "OBSIDIAN_SEMANTIC_MCP_HOME": "<obsidian_semantic_mcp_home>",
        "OBSIDIAN_EMBED_MODEL": "<obsidian_embed_model>",
        "OLLAMA_BASE_URL": "<ollama_base_url>",
        "OBSIDIAN_SEMANTIC_STARTUP_INDEX": "<obsidian_semantic_startup_index>",
        "OBSIDIAN_SEMANTIC_ALLOW_SENSITIVE": "<obsidian_semantic_allow_sensitive>"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y @dalecb/obsidian-semantic-mcp
§02  Environment variables
OBSIDIAN_VAULT_ROOT
required

Absolute path to the local Obsidian vault.

OBSIDIAN_SEMANTIC_MCP_HOME

Directory for the external SQLite index, logs, and cache.

OBSIDIAN_EMBED_MODEL

Ollama embedding model name. Defaults to bge-m3.

OLLAMA_BASE_URL

Ollama API base URL. Defaults to http://localhost:11434.

OBSIDIAN_SEMANTIC_STARTUP_INDEX

Set to true to run incremental indexing when the server starts.

OBSIDIAN_SEMANTIC_ALLOW_SENSITIVE

Set to true to allow include_sensitive tool calls.

§03  MCP Quality Score  ·  methodology
freshness
25
completeness
15
installability
25
documentation
15
stability
5
§04  Alternatives in Search