Obsidian GitHub MCP

io.github.SarutobiSasuke8/obsidian-github-mcp

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

Connect this server

Add this to your MCP client config — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor).Suits: Claude Desktop · Cursor.

{
  "mcpServers": {
    "obsidian-github-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@sarutobi-sasuke/obsidian-github-mcp@0.1.0"
      ],
      "env": {
        "VAULT_MCP_PORT": "3210",
        "VAULT_MCP_GITHUB_OWNER": "<your VAULT_MCP_GITHUB_OWNER>",
        "VAULT_MCP_GITHUB_REPO": "<your VAULT_MCP_GITHUB_REPO>",
        "VAULT_MCP_POLICY_FILE": "<your VAULT_MCP_POLICY_FILE>",
        "VAULT_MCP_TOKEN_FILE": "<your VAULT_MCP_TOKEN_FILE>",
        "GITHUB_TOKEN": "<your GITHUB_TOKEN>",
        "GITHUB_APP_PRIVATE_KEY_FILE": "<your GITHUB_APP_PRIVATE_KEY_FILE>"
      }
    }
  }
}
Environment variables
  • VAULT_MCP_PORTLoopback HTTP listening port.
  • VAULT_MCP_GITHUB_OWNERrequiredOwner of the operator-authorised vault repository.
  • VAULT_MCP_GITHUB_REPOrequiredOperator-authorised vault repository name.
  • VAULT_MCP_POLICY_FILErequiredAbsolute path to the operator-provisioned policy YAML.
  • VAULT_MCP_TOKEN_FILErequiredAbsolute path to the operator-provisioned client-token YAML.
  • GITHUB_TOKENsecretRequired for the token-based quickstart. Alternatively configure all three GitHub App variables documented in README.
  • GITHUB_APP_PRIVATE_KEY_FILEsecretAbsolute path to the operator-provisioned App private key; required with GITHUB_APP_ID.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Developer Tools
Version
0.1.0
Registry
active
Published
10/24/2026
Browse all Developer Tools →

Add the badge to your site

Show visitors that Obsidian GitHub MCP is listed here — it’s also the link we check for a free listing.

Obsidian GitHub MCP — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-sarutobisasuke8-obsidian-github-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Obsidian GitHub MCP — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Obsidian GitHub MCP — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-sarutobisasuke8-obsidian-github-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.