Obsidian Semantic Search

MCP

by DalecB · v0.2.1

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

mcplocal

MCP configuration

stdio

Command

npx -y @dalecb/obsidian-semantic-mcp@0.2.1

Environment

  • OBSIDIAN_VAULT_ROOTrequired

    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.

  • OBSIDIAN_SEMANTIC_EXCLUDE

    Comma- or newline-separated folders to always exclude from indexing, search, and read.

  • OBSIDIAN_SEMANTIC_SENSITIVE_PATHS

    Comma- or newline-separated folders treated as sensitive (blocked unless unlocked). Defaults to 08_PersonalInfo/.

Install in one click with Zurek

Browse here, install from the native macOS app — pick targets, fill env vars, and write configs safely.