Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

Obsidian Hybrid Search

von flowing-abyssVersion 0.17.7i★ 126iLäuft auf deinem ComputerRepository ↗
Name in der Registryio.github.flowing-abyss/obsidian-hybrid-search

So installierst du es

What it does

Search Obsidian vaults with hybrid full-text, fuzzy, semantic, and graph retrieval.

  • Connects Läuft auf deinem Computer
  • Account or key No key needed · 1 setting to fill in (OBSIDIAN_VAULT_PATH)
  • Category Dokumente, Tabellen & Büroarbeit

Zusammen nutzen mit

Skills, die der KI diese Art Arbeit beibringen; sie funktionieren zusammen mit diesem

MinerU

Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.

von opendatalab★ 83.9721 Skills

Skill · AnleitungKeine Lizenz angegeben

watermarks-remover

A privacy-first app that strips AI watermarks from content you own.

von guillaumemeyer★ 27.7961 Skills

Skill · Anleitung

obsidian-skills

Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.

von kepano★ 53.183 (whole repo)5 Skills

Skill · Anleitung

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit33/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch0/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert45/100

Qualität: 3/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: 41 (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte Obsidian Hybrid Search. Folge https://mcp.popnx.com/i/flowing-abyss-obsidian-hybrid-search.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

3/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 16. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude, aber erst etwas vorbereiten

1 Einstellung(en) auszufüllen (OBSIDIAN_VAULT_PATH) · Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

Von der KI installieren lassen

Kopiere diese Nachricht in einen Claude-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Obsidian Hybrid Search für Claude auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "obsidian-hybrid-search": { "command": "npx", "args": [ "-y", "obsidian-hybrid-search", "mcp" ], "env": { "OBSIDIAN_VAULT_PATH": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei OBSIDIAN_VAULT_PATH "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Obsidian Hybrid Search wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Node.js installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    node -v
    • Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig

    Download-Seite von Node.js öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v

    Einmal installieren, gilt für alles, was Node.js braucht

  2. 1 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • OBSIDIAN_VAULT_PATH Absoluter Pfad zum Obsidian-Vault, der indiziert und durchsucht wird.
      Englisches Original anzeigenAbsolute path to the Obsidian vault to index and search.

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  3. Einstellungsdatei der Claude-Desktop-App öffnen

    SettingsDeveloperEdit Config

  4. Diese Einstellungen einfügen und speichern

    {
      "mcpServers": {
        "obsidian-hybrid-search": {
          "command": "npx",
          "args": [
            "-y",
            "obsidian-hybrid-search",
            "mcp"
          ],
          "env": {
            "OBSIDIAN_VAULT_PATH": "your-value"
          }
        }
      }
    }
  5. Claude beenden und neu öffnen

  6. Ausprobieren

    Nutze Obsidian Hybrid Search und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es Obsidian Hybrid Search nutzt, oder ein Werkzeug von Obsidian Hybrid Search in der Antwort zeigt, bist du verbunden

10 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • OBSIDIAN_PREFIX Optionales Präfix für MCP-Toolnamen bei der Konfiguration mehrerer Vaults.
    Englisches Original anzeigenOptional prefix for MCP tool names when configuring multiple vaults.
  • OBSIDIAN_IGNORE_PATTERNS Durch Kommas getrennte Glob-Muster, die von der Indizierung ausgeschlossen werden.
    Englisches Original anzeigenComma-separated glob patterns to exclude from indexing.
    · Standard .obsidian/**,templates/**,*.canvas
  • OBSIDIAN_RESPECT_GITIGNORE Liest beim Indizieren die anwendbaren .gitignore-Dateien und die Regeln in info/exclude des Repositorys; auf false, 0 oder no setzen, um beides zu deaktivieren.
    Englisches Original anzeigenRead applicable .gitignore files and repository info/exclude rules when indexing; set to false, 0, or no to disable both.
    · Standard true
  • OBSIDIAN_INCLUDE_PATTERNS Durch Kommas getrennte Muster, um Notizen wieder einzubeziehen, die nur durch Git-Ignore-Regeln ausgeschlossen wurden.
    Englisches Original anzeigenComma-separated patterns to re-include notes ignored only by Git ignore rules.
  • OBSIDIAN_CONTENT_IGNORE_PATTERNS Durch Kommas getrennte Regex-Regeln für Notiztext, der von der Suche ausgeschlossen wird, z. B. /%%\s\S?%%/g. Originaldateien und read bleiben unverändert.
    Englisches Original anzeigenComma-separated regex rules for note body text to leave out of search, e.g. /%%[\s\S]*?%%/g. Original files and read stay unchanged.
  • OPENAI_API_KEY Optionaler API-Schlüssel für OpenAI-kompatible Remote-Embeddings; weglassen, um lokale Embeddings zu verwenden.
    Englisches Original anzeigenOptional API key for OpenAI-compatible remote embeddings; omit to use local embeddings.
  • OPENAI_BASE_URL Optionale OpenAI-kompatible API-Basis-URL für OpenRouter, Ollama, LM Studio oder ähnliche Anbieter.
    Englisches Original anzeigenOptional OpenAI-compatible API base URL for OpenRouter, Ollama, LM Studio, or similar providers.
    · Standard https://api.openai.com/v1
  • OPENAI_EMBEDDING_MODEL Name des Remote-Embedding-Modells bei Verwendung einer OpenAI-kompatiblen API.
    Englisches Original anzeigenRemote embedding model name when using an OpenAI-compatible API.
    · Standard text-embedding-3-small
  • LOCAL_EMBEDDING_MODEL Lokales Embedding-Modell, das verwendet wird, wenn keine Remote-Embedding-API konfiguriert ist.
    Englisches Original anzeigenLocal embedding model used when no remote embedding API is configured.
    · Standard Xenova/multilingual-e5-small
  • RERANKER_MODEL Optionales ONNX-Cross-Encoder-Reranker-Modell, das verwendet wird, wenn Reranking angefordert wird.
    Englisches Original anzeigenOptional ONNX cross-encoder reranker model used when reranking is requested.
    · Standard onnx-community/gte-multilingual-reranker-base

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann Obsidian Hybrid Search noch nicht verbinden

Obsidian Hybrid Search läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen

Das kannst du stattdessen tun

A · Eine App nutzen, die Obsidian Hybrid Search verbinden kann

  • 1 Einstellung(en) auszufüllen (OBSIDIAN_VAULT_PATH) · Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
  • 1 Einstellung(en) auszufüllen (OBSIDIAN_VAULT_PATH) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
  • 1 Einstellung(en) auszufüllen (OBSIDIAN_VAULT_PATH) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
  • 1 Einstellung(en) auszufüllen (OBSIDIAN_VAULT_PATH) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

B · Andere in Dokumente, Tabellen & Büroarbeit, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Klappt mit Claude Code, aber erst etwas vorbereiten

1 Einstellung(en) auszufüllen (OBSIDIAN_VAULT_PATH) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen Claude Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Obsidian Hybrid Search für Claude Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): claude mcp add --scope user obsidian-hybrid-search --env OBSIDIAN_VAULT_PATH=your-value -- npx -y obsidian-hybrid-search mcp 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei OBSIDIAN_VAULT_PATH "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Obsidian Hybrid Search wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Node.js installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    node -v
    • Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig

    Download-Seite von Node.js öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v

    Einmal installieren, gilt für alles, was Node.js braucht

  2. 1 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • OBSIDIAN_VAULT_PATH Absoluter Pfad zum Obsidian-Vault, der indiziert und durchsucht wird.
      Englisches Original anzeigenAbsolute path to the Obsidian vault to index and search.

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  3. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  4. Diesen Befehl einfügen und Enter drücken

    claude mcp add --scope user obsidian-hybrid-search --env OBSIDIAN_VAULT_PATH=your-value -- npx -y obsidian-hybrid-search mcp
  5. /mcp in Claude Code eingeben

    Obsidian Hybrid Search sollte in der Liste als verbunden erscheinen

  6. Ausprobieren

    Nutze Obsidian Hybrid Search und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es Obsidian Hybrid Search nutzt, oder ein Werkzeug von Obsidian Hybrid Search in der Antwort zeigt, bist du verbunden

10 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • OBSIDIAN_PREFIX Optionales Präfix für MCP-Toolnamen bei der Konfiguration mehrerer Vaults.
    Englisches Original anzeigenOptional prefix for MCP tool names when configuring multiple vaults.
  • OBSIDIAN_IGNORE_PATTERNS Durch Kommas getrennte Glob-Muster, die von der Indizierung ausgeschlossen werden.
    Englisches Original anzeigenComma-separated glob patterns to exclude from indexing.
    · Standard .obsidian/**,templates/**,*.canvas
  • OBSIDIAN_RESPECT_GITIGNORE Liest beim Indizieren die anwendbaren .gitignore-Dateien und die Regeln in info/exclude des Repositorys; auf false, 0 oder no setzen, um beides zu deaktivieren.
    Englisches Original anzeigenRead applicable .gitignore files and repository info/exclude rules when indexing; set to false, 0, or no to disable both.
    · Standard true
  • OBSIDIAN_INCLUDE_PATTERNS Durch Kommas getrennte Muster, um Notizen wieder einzubeziehen, die nur durch Git-Ignore-Regeln ausgeschlossen wurden.
    Englisches Original anzeigenComma-separated patterns to re-include notes ignored only by Git ignore rules.
  • OBSIDIAN_CONTENT_IGNORE_PATTERNS Durch Kommas getrennte Regex-Regeln für Notiztext, der von der Suche ausgeschlossen wird, z. B. /%%\s\S?%%/g. Originaldateien und read bleiben unverändert.
    Englisches Original anzeigenComma-separated regex rules for note body text to leave out of search, e.g. /%%[\s\S]*?%%/g. Original files and read stay unchanged.
  • OPENAI_API_KEY Optionaler API-Schlüssel für OpenAI-kompatible Remote-Embeddings; weglassen, um lokale Embeddings zu verwenden.
    Englisches Original anzeigenOptional API key for OpenAI-compatible remote embeddings; omit to use local embeddings.
  • OPENAI_BASE_URL Optionale OpenAI-kompatible API-Basis-URL für OpenRouter, Ollama, LM Studio oder ähnliche Anbieter.
    Englisches Original anzeigenOptional OpenAI-compatible API base URL for OpenRouter, Ollama, LM Studio, or similar providers.
    · Standard https://api.openai.com/v1
  • OPENAI_EMBEDDING_MODEL Name des Remote-Embedding-Modells bei Verwendung einer OpenAI-kompatiblen API.
    Englisches Original anzeigenRemote embedding model name when using an OpenAI-compatible API.
    · Standard text-embedding-3-small
  • LOCAL_EMBEDDING_MODEL Lokales Embedding-Modell, das verwendet wird, wenn keine Remote-Embedding-API konfiguriert ist.
    Englisches Original anzeigenLocal embedding model used when no remote embedding API is configured.
    · Standard Xenova/multilingual-e5-small
  • RERANKER_MODEL Optionales ONNX-Cross-Encoder-Reranker-Modell, das verwendet wird, wenn Reranking angefordert wird.
    Englisches Original anzeigenOptional ONNX cross-encoder reranker model used when reranking is requested.
    · Standard onnx-community/gte-multilingual-reranker-base

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor, aber erst etwas vorbereiten

1 Einstellung(en) auszufüllen (OBSIDIAN_VAULT_PATH) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen Cursor-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Obsidian Hybrid Search für Cursor auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "obsidian-hybrid-search": { "command": "npx", "args": [ "-y", "obsidian-hybrid-search", "mcp" ], "env": { "OBSIDIAN_VAULT_PATH": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei OBSIDIAN_VAULT_PATH "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Obsidian Hybrid Search wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Node.js installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    node -v
    • Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig

    Download-Seite von Node.js öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v

    Einmal installieren, gilt für alles, was Node.js braucht

  2. 1 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • OBSIDIAN_VAULT_PATH Absoluter Pfad zum Obsidian-Vault, der indiziert und durchsucht wird.
      Englisches Original anzeigenAbsolute path to the Obsidian vault to index and search.

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  3. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  4. Schlüssel eintragen

    In den Einstellungen von Obsidian Hybrid Search ist OBSIDIAN_VAULT_PATH leer; trag deinen Schlüssel ein und speichere

  5. KI-Chat in Cursor im Agent-Modus öffnen

  6. Ausprobieren

    Nutze Obsidian Hybrid Search und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es Obsidian Hybrid Search nutzt, oder ein Werkzeug von Obsidian Hybrid Search in der Antwort zeigt, bist du verbunden

10 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • OBSIDIAN_PREFIX Optionales Präfix für MCP-Toolnamen bei der Konfiguration mehrerer Vaults.
    Englisches Original anzeigenOptional prefix for MCP tool names when configuring multiple vaults.
  • OBSIDIAN_IGNORE_PATTERNS Durch Kommas getrennte Glob-Muster, die von der Indizierung ausgeschlossen werden.
    Englisches Original anzeigenComma-separated glob patterns to exclude from indexing.
    · Standard .obsidian/**,templates/**,*.canvas
  • OBSIDIAN_RESPECT_GITIGNORE Liest beim Indizieren die anwendbaren .gitignore-Dateien und die Regeln in info/exclude des Repositorys; auf false, 0 oder no setzen, um beides zu deaktivieren.
    Englisches Original anzeigenRead applicable .gitignore files and repository info/exclude rules when indexing; set to false, 0, or no to disable both.
    · Standard true
  • OBSIDIAN_INCLUDE_PATTERNS Durch Kommas getrennte Muster, um Notizen wieder einzubeziehen, die nur durch Git-Ignore-Regeln ausgeschlossen wurden.
    Englisches Original anzeigenComma-separated patterns to re-include notes ignored only by Git ignore rules.
  • OBSIDIAN_CONTENT_IGNORE_PATTERNS Durch Kommas getrennte Regex-Regeln für Notiztext, der von der Suche ausgeschlossen wird, z. B. /%%\s\S?%%/g. Originaldateien und read bleiben unverändert.
    Englisches Original anzeigenComma-separated regex rules for note body text to leave out of search, e.g. /%%[\s\S]*?%%/g. Original files and read stay unchanged.
  • OPENAI_API_KEY Optionaler API-Schlüssel für OpenAI-kompatible Remote-Embeddings; weglassen, um lokale Embeddings zu verwenden.
    Englisches Original anzeigenOptional API key for OpenAI-compatible remote embeddings; omit to use local embeddings.
  • OPENAI_BASE_URL Optionale OpenAI-kompatible API-Basis-URL für OpenRouter, Ollama, LM Studio oder ähnliche Anbieter.
    Englisches Original anzeigenOptional OpenAI-compatible API base URL for OpenRouter, Ollama, LM Studio, or similar providers.
    · Standard https://api.openai.com/v1
  • OPENAI_EMBEDDING_MODEL Name des Remote-Embedding-Modells bei Verwendung einer OpenAI-kompatiblen API.
    Englisches Original anzeigenRemote embedding model name when using an OpenAI-compatible API.
    · Standard text-embedding-3-small
  • LOCAL_EMBEDDING_MODEL Lokales Embedding-Modell, das verwendet wird, wenn keine Remote-Embedding-API konfiguriert ist.
    Englisches Original anzeigenLocal embedding model used when no remote embedding API is configured.
    · Standard Xenova/multilingual-e5-small
  • RERANKER_MODEL Optionales ONNX-Cross-Encoder-Reranker-Modell, das verwendet wird, wenn Reranking angefordert wird.
    Englisches Original anzeigenOptional ONNX cross-encoder reranker model used when reranking is requested.
    · Standard onnx-community/gte-multilingual-reranker-base

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code, aber erst etwas vorbereiten

1 Einstellung(en) auszufüllen (OBSIDIAN_VAULT_PATH) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen VS Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Obsidian Hybrid Search für VS Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "servers": { "obsidian-hybrid-search": { "type": "stdio", "command": "npx", "args": [ "-y", "obsidian-hybrid-search", "mcp" ], "env": { "OBSIDIAN_VAULT_PATH": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei OBSIDIAN_VAULT_PATH "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Obsidian Hybrid Search wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Node.js installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    node -v
    • Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig

    Download-Seite von Node.js öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v

    Einmal installieren, gilt für alles, was Node.js braucht

  2. 1 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • OBSIDIAN_VAULT_PATH Absoluter Pfad zum Obsidian-Vault, der indiziert und durchsucht wird.
      Englisches Original anzeigenAbsolute path to the Obsidian vault to index and search.

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  3. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  4. Schlüssel eintragen

    In den Einstellungen von Obsidian Hybrid Search ist OBSIDIAN_VAULT_PATH leer; trag deinen Schlüssel ein und speichere

  5. KI-Chat in VS Code im Agent-Modus öffnen

  6. Ausprobieren

    Nutze Obsidian Hybrid Search und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es Obsidian Hybrid Search nutzt, oder ein Werkzeug von Obsidian Hybrid Search in der Antwort zeigt, bist du verbunden

10 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • OBSIDIAN_PREFIX Optionales Präfix für MCP-Toolnamen bei der Konfiguration mehrerer Vaults.
    Englisches Original anzeigenOptional prefix for MCP tool names when configuring multiple vaults.
  • OBSIDIAN_IGNORE_PATTERNS Durch Kommas getrennte Glob-Muster, die von der Indizierung ausgeschlossen werden.
    Englisches Original anzeigenComma-separated glob patterns to exclude from indexing.
    · Standard .obsidian/**,templates/**,*.canvas
  • OBSIDIAN_RESPECT_GITIGNORE Liest beim Indizieren die anwendbaren .gitignore-Dateien und die Regeln in info/exclude des Repositorys; auf false, 0 oder no setzen, um beides zu deaktivieren.
    Englisches Original anzeigenRead applicable .gitignore files and repository info/exclude rules when indexing; set to false, 0, or no to disable both.
    · Standard true
  • OBSIDIAN_INCLUDE_PATTERNS Durch Kommas getrennte Muster, um Notizen wieder einzubeziehen, die nur durch Git-Ignore-Regeln ausgeschlossen wurden.
    Englisches Original anzeigenComma-separated patterns to re-include notes ignored only by Git ignore rules.
  • OBSIDIAN_CONTENT_IGNORE_PATTERNS Durch Kommas getrennte Regex-Regeln für Notiztext, der von der Suche ausgeschlossen wird, z. B. /%%\s\S?%%/g. Originaldateien und read bleiben unverändert.
    Englisches Original anzeigenComma-separated regex rules for note body text to leave out of search, e.g. /%%[\s\S]*?%%/g. Original files and read stay unchanged.
  • OPENAI_API_KEY Optionaler API-Schlüssel für OpenAI-kompatible Remote-Embeddings; weglassen, um lokale Embeddings zu verwenden.
    Englisches Original anzeigenOptional API key for OpenAI-compatible remote embeddings; omit to use local embeddings.
  • OPENAI_BASE_URL Optionale OpenAI-kompatible API-Basis-URL für OpenRouter, Ollama, LM Studio oder ähnliche Anbieter.
    Englisches Original anzeigenOptional OpenAI-compatible API base URL for OpenRouter, Ollama, LM Studio, or similar providers.
    · Standard https://api.openai.com/v1
  • OPENAI_EMBEDDING_MODEL Name des Remote-Embedding-Modells bei Verwendung einer OpenAI-kompatiblen API.
    Englisches Original anzeigenRemote embedding model name when using an OpenAI-compatible API.
    · Standard text-embedding-3-small
  • LOCAL_EMBEDDING_MODEL Lokales Embedding-Modell, das verwendet wird, wenn keine Remote-Embedding-API konfiguriert ist.
    Englisches Original anzeigenLocal embedding model used when no remote embedding API is configured.
    · Standard Xenova/multilingual-e5-small
  • RERANKER_MODEL Optionales ONNX-Cross-Encoder-Reranker-Modell, das verwendet wird, wenn Reranking angefordert wird.
    Englisches Original anzeigenOptional ONNX cross-encoder reranker model used when reranking is requested.
    · Standard onnx-community/gte-multilingual-reranker-base

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Obsidian Hybrid Search nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user obsidian-hybrid-search --env OBSIDIAN_VAULT_PATH=your-value -- npx -y obsidian-hybrid-search mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "obsidian-hybrid-search": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-hybrid-search",
        "mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "obsidian-hybrid-search": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-hybrid-search",
        "mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "obsidian-hybrid-search": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "obsidian-hybrid-search",
        "mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

  • OBSIDIAN_VAULT_PATH erforderlich env
    Absoluter Pfad zum Obsidian-Vault, der indiziert und durchsucht wird.
    Englisches Original anzeigenAbsolute path to the Obsidian vault to index and search.
  • OBSIDIAN_PREFIX env
    Optionales Präfix für MCP-Toolnamen bei der Konfiguration mehrerer Vaults.
    Englisches Original anzeigenOptional prefix for MCP tool names when configuring multiple vaults.
  • OBSIDIAN_IGNORE_PATTERNS env
    Durch Kommas getrennte Glob-Muster, die von der Indizierung ausgeschlossen werden.
    Englisches Original anzeigenComma-separated glob patterns to exclude from indexing.
  • OBSIDIAN_RESPECT_GITIGNORE env
    Liest beim Indizieren die anwendbaren .gitignore-Dateien und die Regeln in info/exclude des Repositorys; auf false, 0 oder no setzen, um beides zu deaktivieren.
    Englisches Original anzeigenRead applicable .gitignore files and repository info/exclude rules when indexing; set to false, 0, or no to disable both.
  • OBSIDIAN_INCLUDE_PATTERNS env
    Durch Kommas getrennte Muster, um Notizen wieder einzubeziehen, die nur durch Git-Ignore-Regeln ausgeschlossen wurden.
    Englisches Original anzeigenComma-separated patterns to re-include notes ignored only by Git ignore rules.
  • OBSIDIAN_CONTENT_IGNORE_PATTERNS env
    Durch Kommas getrennte Regex-Regeln für Notiztext, der von der Suche ausgeschlossen wird, z. B. /%%\s\S?%%/g. Originaldateien und read bleiben unverändert.
    Englisches Original anzeigenComma-separated regex rules for note body text to leave out of search, e.g. /%%[\s\S]*?%%/g. Original files and read stay unchanged.
  • OPENAI_API_KEY geheim env
    Optionaler API-Schlüssel für OpenAI-kompatible Remote-Embeddings; weglassen, um lokale Embeddings zu verwenden.
    Englisches Original anzeigenOptional API key for OpenAI-compatible remote embeddings; omit to use local embeddings.
  • OPENAI_BASE_URL env
    Optionale OpenAI-kompatible API-Basis-URL für OpenRouter, Ollama, LM Studio oder ähnliche Anbieter.
    Englisches Original anzeigenOptional OpenAI-compatible API base URL for OpenRouter, Ollama, LM Studio, or similar providers.
  • OPENAI_EMBEDDING_MODEL env
    Name des Remote-Embedding-Modells bei Verwendung einer OpenAI-kompatiblen API.
    Englisches Original anzeigenRemote embedding model name when using an OpenAI-compatible API.
  • LOCAL_EMBEDDING_MODEL env
    Lokales Embedding-Modell, das verwendet wird, wenn keine Remote-Embedding-API konfiguriert ist.
    Englisches Original anzeigenLocal embedding model used when no remote embedding API is configured.
  • RERANKER_MODEL env
    Optionales ONNX-Cross-Encoder-Reranker-Modell, das verwendet wird, wenn Reranking angefordert wird.
    Englisches Original anzeigenOptional ONNX cross-encoder reranker model used when reranking is requested.

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
1.272/Wo.
Verbindung
Läuft auf deinem Computer
Neueste Versioni
0.17.7
In der Registry veröffentlichti
16. Nov. 2026
Code zuletzt geänderti
16. Nov. 2026
Entwickler
flowing-abyss
Pakete
npm: obsidian-hybrid-search
Website
github.com
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto flowing-abyss bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 3 Tagen

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • – Nicht zutreffend

    Endpunkt antwortet

    Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Veröffentlichte Schwachstellen (OSV.dev)

Noch nicht geprüft

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/flowing-abyss-obsidian-hybrid-search.svg)](https://mcp.popnx.com/en/servers/flowing-abyss-obsidian-hybrid-search)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Dokumente, Tabellen & Büroarbeiti

  • Mehr Sterne als 98 % der anderen 4140 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 89 % der anderen 4140 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 4140 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Obsidian Hybrid Search sicher?

Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 3 Tagen geändert, und die neueste Version (0.17.7) kam vor 3 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Puter MCP

Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more

von HeyPuterWeit verbreitet★ 44.205Aktualisiert vor 5 Monaten

Läuft in der Cloud✓ vom Dienst · puter.com

XcodeBuildMCP

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

von getsentryWeit verbreitet↓ 130.486/Wo. geteiltes Paket★ 6588Aktualisiert vor 4 Monaten

Läuft auf deinem Computer✓ vom Dienst · xcodebuildmcp.com

Vexa

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

von Vexa-aiWeit verbreitet★ 2996Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · vexa.ai

Atlassian Rovo MCP Server

Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.

von atlassianWachsend★ 1177Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · atlassian.com

Anki MCP Server

MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.

von ankimcpWachsend↓ 1136/Wo.★ 568Aktualisiert letzten Monat

Läuft auf deinem Computer✓ vom Dienst · ankimcp.ai
Im Vergleich mit ähnlichen
Dieser
Obsidian Hybrid Search
Puter MCPXcodeBuildMCPVexaAtlassian Rovo MCP ServerAnki MCP Server
Läuft woWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationWird auf deinem Rechner installiert
Braucht SchlüsselNeinNeinNeinJaNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinJaNein
Basisprüfungen3/34/43/32/44/43/3
LizenzMITAGPL-3.0MITApache-2.0Apache-2.0MIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

Obsidian Hybrid Search

Your Obsidian vault already contains your best thinking. Obsidian Hybrid Search makes that thinking easier to find, reuse, and bring into AI-assisted work.

It gives your vault one retrieval engine and three practical ways to use it. The native Obsidian plugin gives you fast search, previews, similar notes, link discovery, and graph views while you write. The MCP server lets AI agents search and read your notes as tool calls. The CLI gives power users the same engine for indexing, filtering, reranking, reading, and scripting.

The search understands how real vaults are built. It combines semantic search, BM25 full text, fuzzy title and alias matching, tags, folders, frontmatter, wikilinks, backlinks, and similar-note lookup. You can search by idea, phrase, title, relationship, or metadata without remembering the exact words you wrote.

That turns Obsidian into a stronger personal knowledge system and a better starting point for AI work. Agents can begin from your own notes, pull cited context from source files, follow related material, and work with knowledge you already trust. OHS runs locally by default with SQLite, FTS5, sqlite-vec, RRF ranking, and optional OpenAI-compatible embedding APIs.

Search quality

Evaluated on the Obsidian Help vault (171 notes, 58 queries, local models):

ConfigurationnDCG@5 ↑MRR ↑Hit@1 ↑Avg query (ms) ↓Model download ↓
OHS Qwen, rerank ¹0.8120.85779.3%730~980 MB
OHS Qwen, hybrid ¹0.8020.85681.0%38~639 MB
OHS default, rerank ²0.7790.83777.6%718~458 MB
OHS default, hybrid ²0.7430.79972.4%8~117 MB
QMD, rerank ³0.7270.73560.3%12,308~973 MB
QMD, full ³0.7130.70655.2%25,306~2.2 GB
QMD, hybrid ³0.6850.70360.3%14~334 MB

¹ GPU (Apple Silicon Metal, Ollama). ² CPU (Apple Silicon). ³ GPU (Apple Silicon Metal).

Default uses Xenova/multilingual-e5-small; Qwen uses qwen3-embedding:0.6b. QMD was tested at v2.8.3.

How to reproduce → · Full benchmark →

Real knowledge-vault benchmark

OHS is also evaluated on Andy Matuschak’s public evergreen notes, converted into an Obsidian vault with title-based note filenames, source URLs in frontmatter, local attachments, and 5,000+ internal note links across 1,357 notes.

The curated golden set includes 78 hand-judged queries across known-item lookup, paraphrases, quote fragments, ambiguous topics, citation lookup, and multi-note evidence.

Using the default local embedding model, OHS performs strongly on this dense note network.

MetricValue
nDCG@50.721
nDCG@100.754
MRR0.875
Hit@10.795
Hit@50.962
Recall@100.972
AllRel@100.949

The benchmark exercises retrieval over a highly connected real-world knowledge vault, including queries that do not simply repeat note titles.

Result JSON · Reproduce and interpret →

Large memory benchmark

To test retrieval on a larger public dataset, LongMemEval-S was converted into a 22,419-note Obsidian-style vault with 470 retrieval queries. Using baai/bge-m3 embeddings, OHS ranked the answer-bearing notes strongly:

MetricValue
nDCG@50.895
MRR0.920
Hit@10.889
Hit@50.968
Recall@100.950
AllRel@100.904

For this benchmark, each query uses the LongMemEval-provided haystack as its search scope. That makes the result reproducible and easy to inspect query by query, while still exercising retrieval over a large generated memory vault.

Result JSON · Reproduce and interpret →

Features

  • Hybrid search
  • BM25 + fuzzy title + semantic embeddings, fused with RRF
  • Alias search
  • notes with aliases: in frontmatter are indexed and searchable by any alias; alias matches are boosted in BM25 (weight 5×) and fuzzy title scoring
  • Four search modes
  • hybrid, semantic, fulltext, title (for text queries)
  • Similar note lookup
  • pass --path to find semantically related notes using stored chunk embeddings, with a title + content fallback
  • Graph traversal
  • --path --related shows linked notes at configurable depth; filter by --direction outgoing|backlinks|both
  • Links & backlinks
  • every result includes outgoing links and backlinks
  • Scope filtering
  • restrict to subfolder(s); supports multiple values and exclusions (-notes/dev/)
  • Tag filtering
  • filter by tag(s); supports multiple values and exclusions (-category/cs)
  • Snippet control
  • --snippet-length sets the context window; empty snippets always fall back to note content
  • Extended output
  • --extended adds a TAGS/ALIASES column to the CLI table showing frontmatter tags (#tag) and aliases
  • Incremental indexing
  • only re-indexes changed files; watches for edits in real time
  • Multi-query fan-out
  • pass multiple queries at once (ohs "q1" "q2" or queries[] in MCP); results are merged via RRF, so a note that ranks well in any one query floats to the top; useful when the note may use different vocabulary than the query
  • Cross-encoder reranking
  • --rerank re-scores results with gte-multilingual-reranker-base (ONNX int8, ~341 MB download once); improves precision for conceptual and multilingual queries; applied after multi-query merge
  • Local embeddings
  • works offline via @huggingface/transformers (no API key required); default model: Xenova/multilingual-e5-small, 100+ languages
  • Remote embeddings
  • OpenAI-compatible API (OpenRouter, Ollama, etc.)
  • Note reading
  • read fetches one or more notes by vault-relative path; returns full content with title, aliases, tags, links, and backlinks; on path miss returns top-3 fuzzy suggestions
  • Ignore patterns
  • exclude folders, extensions, or specific files
  • Obsidian plugin
  • native search modal inside Obsidian powered by the same CLI; see obsidian-hybrid-search-plugin

Installation

npm install -g obsidian-hybrid-search

CLI usage

Quick start

The recommended setup is to set OBSIDIAN_VAULT_PATH once in ~/.zshrc or ~/.bashrc. This lets you run the CLI from any directory.

export OBSIDIAN_VAULT_PATH="/path/to/your/vault"

Open a new terminal and index the vault once.

ohs reindex

You can now search from any directory.

ohs "zettelkasten"
Run from a vault

Alternatively, run the CLI without an environment variable from any directory inside your vault. It finds the vault root by walking up to the nearest .obsidian/ folder.

cd /path/to/your/vault

ohs reindex ohs "zettelkasten"

From outside the vault, set OBSIDIAN_VAULT_PATH or pass --db /path/to/vault/.obsidian-hybrid-search.db explicitly.

Optional remote embeddings

By default, the CLI uses the local Xenova/multilingual-e5-small model. It works offline without an API key, downloads about 117 MB on first use, and supports more than 100 languages.

To use a remote API, add its settings to your shell profile.

export OPENAI_API_KEY="sk-..."

Override the default API base for another provider

export OPENAI_BASE_URL="https://openrouter.ai/api/v1" # OpenRouter

export OPENAI_BASE_URL="http://localhost:11434/v1" # Ollama (no key needed)

export OPENAI_BASE_URL="http://localhost:1234/v1" # LM Studio (no key needed)

Override the default text-embedding-3-small model

export OPENAI_EMBEDDING_MODEL="text-embedding-3-small"

Search modes

The CLI supports four search modes called hybrid, fulltext, semantic, and title, plus graph traversal for linked notes. The commands below show how to use them, apply filters, rerank results, and control the output.

# Hybrid search (default)

ohs "zettelkasten atomic notes"

Fulltext BM25 search

ohs "permanent notes" --mode fulltext

Fuzzy title search (fast, typo-tolerant)

ohs "zettleksten" --mode title

Semantic / vector search

ohs "how to build a knowledge graph" --mode semantic

Limit results and set a score threshold

ohs "productivity systems" --limit 5 --threshold 0.3

Restrict to a subfolder

ohs "daily review" --scope notes/periodic/ ohs "daily review" --folder notes/periodic/ # alias for --scope

Restrict to multiple subfolders (OR)

ohs "productivity" --scope notes/pkm/ --scope notes/2024/

Exclude a subfolder

ohs "programming" --scope notes/ --scope -notes/archive/

Filter by tag

ohs "productivity" --tag pkm ohs "machine learning" --tag note/basic/primary

Filter by multiple tags (AND include, exclude with -)

ohs "learning" --tag pkm --tag work

Filter by frontmatter / properties (exact match, case-insensitive)

ohs "notes" --frontmatter status:todo ohs "notes" --prop priority:high # --prop is alias for --frontmatter

Filter by multiple frontmatter fields (AND)

ohs "notes" --frontmatter status:todo --frontmatter priority:high

Exclude by frontmatter value

ohs "notes" --frontmatter -status:done

Filter-only mode: no query, just filters (returns all matching notes sorted by title)

ohs --frontmatter status:todo ohs --folder notes/2024/ ohs --tag pkm ohs --frontmatter status:done --tag archived

Unlimited results in filter-only mode (default limit is 10)

ohs --folder notes/ --limit 0

Find semantically similar notes

ohs --path notes/pkm/zettelkasten.md

Graph traversal: show notes linked to/from this note

Results show depth: -1/-2 = backlinks, 0 = source, +1/+2 = outgoing links

ohs --path notes/pkm/zettelkasten.md --related ohs --path notes/pkm/zettelkasten.md --related --depth 2

Only outgoing links (what this note references)

ohs --path notes/pkm/zettelkasten.md --related --direction outgoing

Only backlinks (who references this note)

ohs --path notes/pkm/zettelkasten.md --related --direction backlinks

Traverse standard Markdown note links instead of Obsidian wikilinks

ohs --path notes/pkm/zettelkasten.md --related --link-type markdown

Traverse both wikilinks and standard Markdown not

Nur der Anfang wird gezeigt; den Rest findest du im Repo