Obsidian GitHub MCP

Name: Obsidian GitHub MCP
Author: SarutobiSasuke8

von SarutobiSasuke8Version 0.1.0i★ –iLäuft auf deinem Computer

Name in der Registryio.github.SarutobiSasuke8/obsidian-github-mcp

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

A permissioned MCP gateway for agent proposals to a Git-backed Obsidian vault.

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiNoch nicht gemessen★ –

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Läuft auf deinem Computer
Transport: Streamable HTTP
Kategorie: Dokumente, Tabellen & Büroarbeit
Das musst du eintragen: VAULT_MCP_GITHUB_OWNER, VAULT_MCP_GITHUB_REPO, VAULT_MCP_POLICY_FILE, VAULT_MCP_TOKEN_FILE, GITHUB_TOKEN, GITHUB_APP_PRIVATE_KEY_FILE

Installation

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

Bevor du installierst

Basischecks: 1 von 1 bestanden
Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
Das trägst du selbst ein: VAULT_MCP_PORT, VAULT_MCP_GITHUB_OWNER, VAULT_MCP_GITHUB_REPO, VAULT_MCP_POLICY_FILE, VAULT_MCP_TOKEN_FILE, GITHUB_TOKEN, GITHUB_APP_ID, GITHUB_APP_INSTALLATION_ID, GITHUB_APP_PRIVATE_KEY_FILE

Als geheim markierte Werte sind Schlüssel zu deinem Konto. Gib sie nie weiter und füge sie nie in einen Chat ein.

Du brauchst

npmNode.js installiert (für den Befehl npx)

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein

{
  "mcpServers": {
    "obsidian-github": {
      "command": "npx",
      "args": [
        "-y",
        "@sarutobi-sasuke/obsidian-github-mcp"
      ],
      "env": {
        "VAULT_MCP_PORT": "your-value",
        "VAULT_MCP_GITHUB_OWNER": "your-value",
        "VAULT_MCP_GITHUB_REPO": "your-value",
        "VAULT_MCP_POLICY_FILE": "your-value",
        "VAULT_MCP_TOKEN_FILE": "your-value",
        "GITHUB_TOKEN": "your-value",
        "GITHUB_APP_ID": "your-value",
        "GITHUB_APP_INSTALLATION_ID": "your-value",
        "GITHUB_APP_PRIVATE_KEY_FILE": "your-value"
      }
    }
  }
}

Führe das in deinem Terminal aus

claude mcp add obsidian-github --env VAULT_MCP_PORT=your-value --env VAULT_MCP_GITHUB_OWNER=your-value --env VAULT_MCP_GITHUB_REPO=your-value --env VAULT_MCP_POLICY_FILE=your-value --env VAULT_MCP_TOKEN_FILE=your-value --env GITHUB_TOKEN=your-value --env GITHUB_APP_ID=your-value --env GITHUB_APP_INSTALLATION_ID=your-value --env GITHUB_APP_PRIVATE_KEY_FILE=your-value -- npx -y @sarutobi-sasuke/obsidian-github-mcp

Trag die leeren Werte ein, bevor du ihn startest.

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "mcpServers": {
    "obsidian-github": {
      "command": "npx",
      "args": [
        "-y",
        "@sarutobi-sasuke/obsidian-github-mcp"
      ],
      "env": {
        "VAULT_MCP_PORT": "your-value",
        "VAULT_MCP_GITHUB_OWNER": "your-value",
        "VAULT_MCP_GITHUB_REPO": "your-value",
        "VAULT_MCP_POLICY_FILE": "your-value",
        "VAULT_MCP_TOKEN_FILE": "your-value",
        "GITHUB_TOKEN": "your-value",
        "GITHUB_APP_ID": "your-value",
        "GITHUB_APP_INSTALLATION_ID": "your-value",
        "GITHUB_APP_PRIVATE_KEY_FILE": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "servers": {
    "obsidian-github": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@sarutobi-sasuke/obsidian-github-mcp"
      ],
      "env": {
        "VAULT_MCP_PORT": "your-value",
        "VAULT_MCP_GITHUB_OWNER": "your-value",
        "VAULT_MCP_GITHUB_REPO": "your-value",
        "VAULT_MCP_POLICY_FILE": "your-value",
        "VAULT_MCP_TOKEN_FILE": "your-value",
        "GITHUB_TOKEN": "your-value",
        "GITHUB_APP_ID": "your-value",
        "GITHUB_APP_INSTALLATION_ID": "your-value",
        "GITHUB_APP_PRIVATE_KEY_FILE": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Werte, die du selbst einträgst

VAULT_MCP_PORT env
Loopback HTTP listening port.
VAULT_MCP_GITHUB_OWNER erforderlich env
Owner of the operator-authorised vault repository.
VAULT_MCP_GITHUB_REPO erforderlich env
Operator-authorised vault repository name.
VAULT_MCP_POLICY_FILE erforderlich env
Absolute path to the operator-provisioned policy YAML.
VAULT_MCP_TOKEN_FILE erforderlich env
Absolute path to the operator-provisioned client-token YAML.
GITHUB_TOKEN geheim env
Required for the token-based quickstart. Alternatively configure all three GitHub App variables documented in README.
GITHUB_APP_ID env
GitHub App alternative: set all three App variables instead of GITHUB_TOKEN.
GITHUB_APP_INSTALLATION_ID env
GitHub App installation ID, required with GITHUB_APP_ID.
GITHUB_APP_PRIVATE_KEY_FILE geheim env
Absolute path to the operator-provisioned App private key; required with GITHUB_APP_ID.

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

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 6. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto SarutobiSasuke8 bestätigt, dem das Repo gehört
… Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
– 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

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

Mehr Sterne als 0 % der anderen 2176 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 71 % der anderen 2176 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 2176 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 GitHub MCP sicher?

Er hat 1 von 1 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?

Das musst du eintragen: VAULT_MCP_GITHUB_OWNER, VAULT_MCP_GITHUB_REPO, VAULT_MCP_POLICY_FILE, VAULT_MCP_TOKEN_FILE, GITHUB_TOKEN, GITHUB_APP_PRIVATE_KEY_FILE

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 – geändert, und die neueste Version (0.1.0) kam vor 13 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: Agent-Native Calendar, Excel MCP Server, MCP Server for Excel

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

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

Agent-Native Calendar

von BuilderIO

Agent-Native Google Calendar - manage events, sync, and public booking

Läuft in der Cloud★ 7.620MITAktualisiert vor 2 Monaten

Installieren

Excel MCP Server

von haris-musa

Create and edit Excel files with AI: charts, PivotTables, formulas. No Excel needed.

Läuft auf deinem Computer★ 4.276MITAktualisiert vor 6 Tagen

Installieren

MCP Server for Excel

von sbroenne

Excel automation for AI - Sheets, Power Query, DAX, VBA, Tables, Ranges and more. Windows only.

Läuft auf deinem Computer★ 847MITAktualisiert vor 3 Tagen

Installieren

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 GitHub MCP

A white-label Model Context Protocol server that gives selected AI agents bounded, auditable access to propose changes to an Obsidian vault stored in GitHub.

Each agent receives its own expiring MCP bearer token. The GitHub credential remains server-side. Read and write paths, denials, protected surfaces, proposal branches, and token revocation are controlled by operator-owned YAML files.

This is an independent open-source project. It is not affiliated with or endorsed by Obsidian or GitHub.

Why use it?

Giving an agent a general GitHub token is difficult to constrain and easy to misuse. This server creates a narrower boundary:

AI agent + individual MCP token

The service has no tools for deleting files, merging branches, pushing to main or master, changing repository settings, editing workflows, or exposing credentials.

Features

Stateless MCP Streamable HTTP transport
Unique, expiring bearer tokens stored as SHA-256 bindings
Per-agent read, write, and deny path globs
Separate Git broker allowlists and fixed proposal branches
Configurable frontmatter requirements for shared or sensitive surfaces
living, review-first, append-only, and immutable note handling
Path-traversal prevention and file-extension/size allowlists
Credential-shaped-content detection
Repository-restricted GitHub App tokens with PAT fallback for local testing
Content-free JSONL audit records
Host/origin validation, security headers, rate limiting, and HTTP timeouts
Docker, CI, tests, and deployment documentation

MCP tools

Tool	Purpose
`vault_whoami`	Show the authenticated identity, broker, branch, and policy scopes.
`vault_list_allowed_paths`	Explain effective read/write/deny boundaries.
`vault_explain_access`	Dry run a single path. Report whether read, list, or write would be permitted and which policy rule decides it. No GitHub call.
`vault_list_files`	List an authorised directory while filtering denied children.
`vault_read_file`	Read an authorised UTF-8 vault file.
`vault_create_file`	Create a file on the identity's fixed proposal branch.
`vault_update_file`	Update a permitted file while respecting mutability.
`vault_append_file`	Append while preserving all existing bytes.

Requirements

Node.js 22+
An Obsidian vault in a GitHub repository
A dedicated non-default proposal branch for each broker
A GitHub App installed only on the vault repository with Contents: read and write, or a fine-grained PAT for local testing

Quick start

Install from source (the current supported path):

git clone https://github.com/YOUR_ACCOUNT/obsidian-github-mcp.git

cd obsidian-github-mcp npm ci cp .env.example .env cp config/policy.example.yaml config/policy.yaml cp config/tokens.example.yaml config/tokens.yaml npm run token:new npm run check

Configure .env with your GitHub repository and token/app credentials before starting:

npm start

Configure .env (specifying your repository and either a GITHUB_TOKEN or GitHub App credentials), replace the sample policy, and put only the generated token's SHA-256 in config/tokens.yaml. Give the raw bearer token to exactly one MCP client.

To verify a checkout before configuring a running service:

npm ci

npm run check npm run test:e2e

These checks use synthetic notes, mock GitHub responses and loopback transports. They need no GitHub or MCP credentials. Note regressions cover Unicode/path encoding, CRLF frontmatter, malformed metadata, UTF-8 size limits and append-only byte preservation. CI runs the same checks on Linux and Windows with Node.js 22 and 24. The 8 tools listed above are the current server surface; tests do not publish proposals to a real vault.

Once v0.1.0 is published to npm, a global install will also be available:

# Available once v0.1.0 is published (not yet on the npm registry).

npm install -g @sarutobi-sasuke/obsidian-github-mcp

The default endpoints are:

GET  http://127.0.0.1:3210/healthz

POST http://127.0.0.1:3210/mcp

MCP clients must send:

Authorization: Bearer vault_<generated-token>

Permission model

The effective write scope is the intersection of the agent grant and its broker:

policy_version: 1

authority: operator-only

agents:

id: example-writer name: Example Writer role: bounded knowledge worker disclosure_ceiling: internal entry_reads: [README.md] read: [Knowledge/, Workspace/] write: [Workspace/Shared/, Workspace/Example Writer/] deny: [Private/, People/, .obsidian/**]

git_brokers:

broker: example-writer branch: agent/example-writer allow: [Workspace/Shared/, Workspace/Example Writer/]

never_versioned: [Private/, People/, .obsidian/, secrets/]

surface_rules:

path: Workspace/Shared/** required_frontmatter: disclosure: public-safe

An auth binding then maps one token hash to that identity and broker. The binding cannot grant paths that the policy does not grant.

See Permissions documentation for provisioning and revocation.

GitHub authentication

Production deployments should use a GitHub App installed only on the vault repository. Configure:

GITHUB_APP_ID=123456

GITHUB_APP_INSTALLATION_ID=12345678 GITHUB_APP_PRIVATE_KEY_FILE=/run/secrets/vault-mcp.pem

The server creates short-lived installation tokens restricted again to the configured repository and contents: write. A repository-scoped GITHUB_TOKEN is supported as a local-development fallback.

Deployment

The included container runs as a non-root user with a read-only root filesystem. Put TLS, a private overlay network, or an authenticated gateway in front of the service before making it remotely reachable.

See Deployment guide.

Verification

npm run check

npm audit --audit-level=high

Tests cover policy parsing, write-scope intersection, deny precedence, traversal attempts, frontmatter rules, mutability, secret detection, token bindings, and fixed-branch GitHub writes.

Run npm run test:e2e for a clean tarball installation and real MCP HTTP client proof against a test-only GitHub substitute. It exercises proposal writes, denied paths/content, immutable and append-only notes, stale-write conflicts, invalid policy reloads, live token revocation and content-free audit records. CI runs this proof on Windows/Linux with Node 22/24, and the release workflow requires it.

Policy and token files reject unknown keys. Only policy_version: 1 and authority: operator-only are supported. Correct misspelt fields or remove unsupported metadata before upgrading; silently ignored restrictions are no longer accepted. Release evidence and remaining gates.

The draft MCP Registry npm entry describes a self-hosted Streamable HTTP process, not a stdio server. A compatible client starts the process with the declared environment and connects to http://127.0.0.1:{VAULT_MCP_PORT}/mcp (port 3210 by default). Supply the existing policy and token-file paths plus the repository owner/name. For GitHub access, use either GITHUB_TOKEN or all three documented GitHub App variables. The manifest cannot express that alternative group; runtime configuration validates it. The process does not create credentials, provision a hosted endpoint or bypass its existing bearer-token checks. The namespace preserves the exact GitHub owner spelling. prepublishOnly includes the registry/package gate; no login or publication is performed by it.

Security

Read Security policy before deployment. Report suspected vulnerabilities privately rather than opening a public issue with exploit details.

License

Apache-2.0. See Apache-2.0 License.

Obsidian GitHub MCP

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Werte, die du selbst einträgst

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

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

Häufige Fragen

Alternativen

Agent-Native Calendar

Excel MCP Server

MCP Server for Excel

README vom Entwickler

Obsidian GitHub MCP

Why use it?

Features

MCP tools

Requirements

Quick start

Configure .env with your GitHub repository and token/app credentials before starting:

Permission model

GitHub authentication

Deployment

Verification

Security

License