Skip to main content
Glama
rileygramlich

obsidian-gate

Obsidian Gate

Ein MCP-Server, der deinen Obsidian-Vault für jeden KI-Agenten öffnet.

npx obsidian-gate init     # point at your vault
npx obsidian-gate          # dashboard on :3100

npm License: MIT


Dein Obsidian-Vault ist dein zweites Gehirn. Deine KI-Agenten sollten ihn nutzen können.

Claude Code, Codex, Cursor — eine Zeile Konfiguration und dein Vault wird zu einem für Agenten zugänglichen Arbeitsbereich. Jede Notiz, jeder Link, jeder Tag. Alles lokal, alles deins, keine Cloud.


Ausprobieren

# One command to set up
npx obsidian-gate init

# Start the dashboard
npx obsidian-gate
# → http://localhost:3100/dashboard

Das war's. Deine Agenten können jetzt deinen Vault lesen, durchsuchen und beschreiben.


Related MCP server: obsidian-autom8

Schnellstart

1. Auf deinen Vault zeigen

npx obsidian-gate init

Du wirst nach deinem Vault-Pfad gefragt. Füge ihn ein und erhalte einen API-Schlüssel.

2. Deinen Agenten verbinden

Claude Code — füge dies in deine MCP-Konfiguration ein:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["obsidian-gate", "--mcp"]
    }
  }
}

Jeder MCP-Client über HTTP:

{
  "mcpServers": {
    "obsidian": {
      "type": "http",
      "url": "http://localhost:3100/mcp",
      "headers": { "Authorization": "Bearer sk-your-key" }
    }
  }
}

3. Frag deinen Agenten

Probiere diese aus:

Prompt

Was passiert

"Woran habe ich gestern gearbeitet?"

Agent liest deine Tagesnotiz

"Durchsuche meinen Vault nach Kubernetes-Notizen"

Volltextsuche über alle Notizen

"Speichere diese Debugging-Sitzung in meinem Vault"

Erstellt eine neue Notiz mit Frontmatter

"Verknüpfe meine Besprechungsnotizen mit den Projektnotizen"

Fügt einen [[wikilink]] hinzu


Tools — 9 Operationen

Tool

Was es tut

list_notes(path?)

Listet Notizen und Ordner in einem Vault-Ordner auf

read_note(path)

Voller Notizinhalt + geparstes Frontmatter

search_notes(query, limit?)

Volltextsuche mit sortierten Ergebnissen und Ausschnitten

create_note(path, content, frontmatter?)

Neue Notiz mit Frontmatter aus der Vault-Vorlage

update_note(path, content, mode?)

Notiz überschreiben oder ergänzen

get_backlinks(path)

Jede Notiz, die hierher über [[wikilink]] verlinkt

get_tags()

Alle Tags — Frontmatter und inline — mit Anzahl

get_daily_note(date?)

Tagesnotiz abrufen oder erstellen (heute, gestern, -1, ISO)

create_link(from, to, label?)

Fügt einen [[wikilink]] unter ## Related hinzu

Notizen sind auch als MCP-Ressourcen verfügbar: obsidian://{vault}/{path}.


CLI

Befehl

Was es tut

init

Interaktiver Einrichtungsassistent

serve (Standard)

Dashboard + MCP HTTP auf :3100

--mcp

Als MCP-Server über stdio ausführen

doctor

Vault-Zugriff und alle 9 Tools prüfen

keys list

Agentenverbindungen anzeigen

keys new <name>

Neuen API-Schlüssel erstellen

keys rotate <id>

Schlüssel rotieren

keys revoke <id>

Schlüssel widerrufen

vault list

Konfigurierte Vaults

vault add <name> <path>

Vault hinzufügen

vault remove <name>

Vault entfernen

license status

Dein Plan und deine Nutzung

license set <key>

Lizenzschlüssel aktivieren

activity

Agenten-Aktivitätsprotokoll


Preise

Stufe

Preis

Was du bekommst

Free

$0

50 Abfragen/Monat, 1 Vault, 1 Agent

Personal

$19/mo

Unbegrenzte Abfragen, 3 Vaults, unbegrenzte Agenten

Team

$49/mo

Alles aus Personal + gemeinsame Konfiguration, Prioritäts-Support

14-tägige kostenlose Testphase für kostenpflichtige Pläne. Kein Risiko. Jederzeit kündbar.


Architektur

┌────────────┐     ┌──────────────────────┐     ┌──────────────┐
│ AI Agent   │────▶│   obsidian-gate      │────▶│  Obsidian    │
│ (Claude,   │◀────│   (MCP Server)       │◀────│  Vault       │
│  Codex,    │     │                      │     │  (files)     │
│  Cursor)   │     │  stdio ─ dashboard   │     └──────────────┘
└────────────┘     └──────────────────────┘
  • Alles lokal. Jedes Byte lebt auf deinem Rechner. Keine Cloud, keine Server, keine Synchronisierung.

  • Konfiguration in ~/.obsidian-gate/config.json (Modus 0600)

  • API-Schlüssel sind lokale Geheimnisse. Du besitzt den Stack.

  • Aktivitätsprotokoll verfolgt jede Agentenaktion in JSONL.


Was Gate nicht ist

  • ❌ Kein Obsidian-Plugin (aber ein Community-Plugin ist geplant)

  • ❌ Keine Synchronisierungs-Engine (liest/schreibt direkt in dein Vault-Verzeichnis)

  • ❌ Kein Notiz-Editor (Obsidian ist darin besser)

  • ❌ Kein Cloud-Dienst (läuft vollständig auf deinem Rechner)

Es ist eine kleine Sache, die gut gemacht ist: ein MCP-Server für deinen Vault.


Roadmap

  • MCP-Server mit 9 Tools

  • Lokales Dashboard + Aktivitätsprotokoll

  • API-Schlüssel-Authentifizierung + Berechtigungen

  • Stripe-Lizenzierung (kostenlose + kostenpflichtige Stufen)

  • Obsidian-Community-Plugin (Installation mit einem Klick)

  • Agent-Rückschreiben mit LLM-Frontmatter

  • Automatisches Tagging aus Vault-Inhalten

  • Tägliche Zusammenfassung: Was hat sich in deinem Vault geändert


Entwicklung

git clone https://github.com/rileygramlich/obsidian-gate.git
cd obsidian-gate
npm install
npm run build     # compile TypeScript → dist/
npm run dev       # hot-reload with tsx

Erstellt von Riley G. — inspiriert vom Marc-Lou-Playbook: schnell liefern, kostenlose Stufe, keine Werbeausgaben, öffentlich bauen.

MIT — baue darauf auf, veröffentliche es, verkaufe es.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to remotely access and interact with Obsidian vaults via MCP, supporting note operations, tag management, graph queries, and command execution.
    4
    GPL 3.0
  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables reading, writing, searching, and managing Obsidian vault notes through MCP tools and prompts, allowing AI agents to interact with local knowledge bases.
    -