protogrid
Sign inAdd to your agent

Search / io.github.SarutobiSasuke8/obsidian-github-mcp

Obsidian GitHub MCP

L0· runs locally

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

v0.1.0 · active · repository · descriptor JSON · versions

Runs on your machine: something must execute the package.Only local packages are published (npm, PyPI, OCI, …). The registry never executes them, so tools are unknown until you run it.
Quality–not scored
Trust91of 100
Packages1
Tools seen0

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "obsidian-github-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@sarutobi-sasuke/[email protected]"
      ],
      "env": {
        "VAULT_MCP_PORT": "3210",
        "VAULT_MCP_GITHUB_OWNER": "${VAULT_MCP_GITHUB_OWNER}",
        "VAULT_MCP_GITHUB_REPO": "${VAULT_MCP_GITHUB_REPO}",
        "VAULT_MCP_POLICY_FILE": "${VAULT_MCP_POLICY_FILE}",
        "VAULT_MCP_TOKEN_FILE": "${VAULT_MCP_TOKEN_FILE}",
        "GITHUB_TOKEN": "${GITHUB_TOKEN}",
        "GITHUB_APP_PRIVATE_KEY_FILE": "${GITHUB_APP_PRIVATE_KEY_FILE}"
      }
    }
  }
}
claude mcp add obsidian-github-mcp -e "VAULT_MCP_PORT=3210" -e "VAULT_MCP_GITHUB_OWNER=${VAULT_MCP_GITHUB_OWNER}" -e "VAULT_MCP_GITHUB_REPO=${VAULT_MCP_GITHUB_REPO}" -e "VAULT_MCP_POLICY_FILE=${VAULT_MCP_POLICY_FILE}" -e "VAULT_MCP_TOKEN_FILE=${VAULT_MCP_TOKEN_FILE}" -e "GITHUB_TOKEN=${GITHUB_TOKEN}" -e "GITHUB_APP_PRIVATE_KEY_FILE=${GITHUB_APP_PRIVATE_KEY_FILE}" -- npx -y @sarutobi-sasuke/[email protected]
[mcp_servers.obsidian-github-mcp]
command = "npx"
args = ["-y", "@sarutobi-sasuke/[email protected]"]
env = { "VAULT_MCP_PORT" = "3210", "VAULT_MCP_GITHUB_OWNER" = "${VAULT_MCP_GITHUB_OWNER}", "VAULT_MCP_GITHUB_REPO" = "${VAULT_MCP_GITHUB_REPO}", "VAULT_MCP_POLICY_FILE" = "${VAULT_MCP_POLICY_FILE}", "VAULT_MCP_TOKEN_FILE" = "${VAULT_MCP_TOKEN_FILE}", "GITHUB_TOKEN" = "${GITHUB_TOKEN}", "GITHUB_APP_PRIVATE_KEY_FILE" = "${GITHUB_APP_PRIVATE_KEY_FILE}" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "obsidian-github-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@sarutobi-sasuke/[email protected]"
      ],
      "enabled": true,
      "environment": {
        "VAULT_MCP_PORT": "3210",
        "VAULT_MCP_GITHUB_OWNER": "{env:VAULT_MCP_GITHUB_OWNER}",
        "VAULT_MCP_GITHUB_REPO": "{env:VAULT_MCP_GITHUB_REPO}",
        "VAULT_MCP_POLICY_FILE": "{env:VAULT_MCP_POLICY_FILE}",
        "VAULT_MCP_TOKEN_FILE": "{env:VAULT_MCP_TOKEN_FILE}",
        "GITHUB_TOKEN": "{env:GITHUB_TOKEN}",
        "GITHUB_APP_PRIVATE_KEY_FILE": "{env:GITHUB_APP_PRIVATE_KEY_FILE}"
      }
    }
  }
}
{
  "mcpServers": {
    "obsidian-github-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@sarutobi-sasuke/[email protected]"
      ],
      "env": {
        "VAULT_MCP_PORT": "3210",
        "VAULT_MCP_GITHUB_OWNER": "${VAULT_MCP_GITHUB_OWNER}",
        "VAULT_MCP_GITHUB_REPO": "${VAULT_MCP_GITHUB_REPO}",
        "VAULT_MCP_POLICY_FILE": "${VAULT_MCP_POLICY_FILE}",
        "VAULT_MCP_TOKEN_FILE": "${VAULT_MCP_TOKEN_FILE}",
        "GITHUB_TOKEN": "${GITHUB_TOKEN}",
        "GITHUB_APP_PRIVATE_KEY_FILE": "${GITHUB_APP_PRIVATE_KEY_FILE}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=obsidian-github-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBzYXJ1dG9iaS1zYXN1a2Uvb2JzaWRpYW4tZ2l0aHViLW1jcEAwLjEuMCJdLCJlbnYiOnsiVkFVTFRfTUNQX1BPUlQiOiIzMjEwIiwiVkFVTFRfTUNQX0dJVEhVQl9PV05FUiI6IiR7VkFVTFRfTUNQX0dJVEhVQl9PV05FUn0iLCJWQVVMVF9NQ1BfR0lUSFVCX1JFUE8iOiIke1ZBVUxUX01DUF9HSVRIVUJfUkVQT30iLCJWQVVMVF9NQ1BfUE9MSUNZX0ZJTEUiOiIke1ZBVUxUX01DUF9QT0xJQ1lfRklMRX0iLCJWQVVMVF9NQ1BfVE9LRU5fRklMRSI6IiR7VkFVTFRfTUNQX1RPS0VOX0ZJTEV9IiwiR0lUSFVCX1RPS0VOIjoiJHtHSVRIVUJfVE9LRU59IiwiR0lUSFVCX0FQUF9QUklWQVRFX0tFWV9GSUxFIjoiJHtHSVRIVUJfQVBQX1BSSVZBVEVfS0VZX0ZJTEV9In19"
}
{
  "servers": {
    "obsidian-github-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@sarutobi-sasuke/[email protected]"
      ],
      "env": {
        "VAULT_MCP_PORT": "3210",
        "VAULT_MCP_GITHUB_OWNER": "${VAULT_MCP_GITHUB_OWNER}",
        "VAULT_MCP_GITHUB_REPO": "${VAULT_MCP_GITHUB_REPO}",
        "VAULT_MCP_POLICY_FILE": "${VAULT_MCP_POLICY_FILE}",
        "VAULT_MCP_TOKEN_FILE": "${VAULT_MCP_TOKEN_FILE}",
        "GITHUB_TOKEN": "${GITHUB_TOKEN}",
        "GITHUB_APP_PRIVATE_KEY_FILE": "${GITHUB_APP_PRIVATE_KEY_FILE}"
      }
    }
  }
}
{
  "mcpServers": {
    "obsidian-github-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@sarutobi-sasuke/[email protected]"
      ],
      "env": {
        "VAULT_MCP_PORT": "3210",
        "VAULT_MCP_GITHUB_OWNER": "${VAULT_MCP_GITHUB_OWNER}",
        "VAULT_MCP_GITHUB_REPO": "${VAULT_MCP_GITHUB_REPO}",
        "VAULT_MCP_POLICY_FILE": "${VAULT_MCP_POLICY_FILE}",
        "VAULT_MCP_TOKEN_FILE": "${VAULT_MCP_TOKEN_FILE}",
        "GITHUB_TOKEN": "${GITHUB_TOKEN}",
        "GITHUB_APP_PRIVATE_KEY_FILE": "${GITHUB_APP_PRIVATE_KEY_FILE}"
      }
    }
  }
}
extensions:
  "obsidian-github-mcp":
    enabled: true
    name: "obsidian-github-mcp"
    type: stdio
    cmd: "npx"
    args:
      - "-y"
      - "@sarutobi-sasuke/[email protected]"
    envs:
      "VAULT_MCP_PORT": "3210"
      "VAULT_MCP_GITHUB_OWNER": "${VAULT_MCP_GITHUB_OWNER}"
      "VAULT_MCP_GITHUB_REPO": "${VAULT_MCP_GITHUB_REPO}"
      "VAULT_MCP_POLICY_FILE": "${VAULT_MCP_POLICY_FILE}"
      "VAULT_MCP_TOKEN_FILE": "${VAULT_MCP_TOKEN_FILE}"
      "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      "GITHUB_APP_PRIVATE_KEY_FILE": "${GITHUB_APP_PRIVATE_KEY_FILE}"
    timeout: 300

Placeholders to fill from your own secret store: ${GITHUB_TOKEN}, ${GITHUB_APP_PRIVATE_KEY_FILE}. The registry never accepts secret values.

This is a local package: the command runs on your machine.

Quality – / 100not scored

Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.

protocoln/a · weight 25
  • n/a
    protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygienen/a · weight 30
  • n/a
    tools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)
stabilityn/a · weight 15
  • n/a
    stability.changes, stability.rug_pulltool list unknown
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvabledeps.dev does not know @sarutobi-sasuke/[email protected]

Tool list unknown · checked 2026-11-07 20:18 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 91 / 100

provenance80
livenessn/a
freshness100
hygiene100

+repository +namespace-matches-repo ~liveness-unmeasured +updated-14d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

@sarutobi-sasuke/[email protected] npmthis version is not known to the dependency resolver

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

packageregistryversionruntimesecrets
@sarutobi-sasuke/obsidian-github-mcpnpm0.1.0–GITHUB_TOKEN, GITHUB_APP_PRIVATE_KEY_FILE

Tools (0)

No tools observed. Local packages are never executed by the registry.

Schemas: list_tools.

Similar MCP servers

  • obsidian-mcp-serverL0
    io.github.cyanheads/obsidian-mcp-server

    Read, write, search, and surgically edit Obsidian notes, tags, and frontmatter via MCP.

  • Obsidian MCP ServerL0
    io.github.maxkuminov/obsidian-mcp

    Self-hosted agent memory as a markdown vault: semantic and keyword search, wikilink graph, OAuth

  • Obsidian MCP ServerL0
    io.github.tylern91/obsidian-mcp-server

    Filesystem-based MCP server for Obsidian vaults — read, search, and edit notes, no app required.

  • Vault CortexL0
    io.github.aliasunder/vault-cortex

    Standalone MCP server for Obsidian vaults — hybrid search, notes & files, memory, tasks, OAuth 2.1

  • Obsidian Vault MCPL0
    io.github.luffysolution-svg/obsidian-vault-mcp

    Local Zotero, MinerU, Obsidian literature workflow with transactional Analysis notes.

  • evc-team-relay-mcpL0
    io.github.entire-vc/evc-team-relay-mcp

    MCP server for AI agent read/write access to Obsidian vaults via EVC Team Relay.

More from io.github.SarutobiSasuke8

  • Agent Handoff MCPL0
    io.github.SarutobiSasuke8/agent-handoff-mcp

    Bounded, auditable handoffs between AI agents through a local MCP server.

  • Aseprite Agent MCPL0
    io.github.SarutobiSasuke8/aseprite-agent-mcp

    Create and verify pixel-art assets with atomic Aseprite edits and Phaser export.

  • Credential BrokerL0
    io.github.SarutobiSasuke8/credential-broker-mcp

    Local-first credential broker: agents use gated APIs through scoped, audited requests, never keys.

  • GIMP Agent MCPL0
    io.github.SarutobiSasuke8/gimp-agent-mcp

    Edit in GIMP 3 with AI agents: live previews, grouped edits, pixel measurements and recipes.

  • JobScout MCPL0
    io.github.SarutobiSasuke8/jobscout-mcp

    Multi-source job discovery, deduplication and AI/Web3 classification for AI agents.

Official server.json
{
  "name": "io.github.SarutobiSasuke8/obsidian-github-mcp",
  "title": "Obsidian GitHub MCP",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "version": "0.1.0",
  "packages": [
    {
      "version": "0.1.0",
      "transport": {
        "url": "http://127.0.0.1:{VAULT_MCP_PORT}/mcp",
        "type": "streamable-http",
        "headers": [
          {
            "name": "Authorization",
            "value": "Bearer {client_token}",
            "variables": {
              "client_token": {
                "isSecret": true,
                "isRequired": true,
                "description": "Existing operator-provisioned MCP client token, not the GitHub token."
              }
            }
          }
        ]
      },
      "identifier": "@sarutobi-sasuke/obsidian-github-mcp",
      "registryType": "npm",
      "environmentVariables": [
        {
          "name": "VAULT_MCP_PORT",
          "default": "3210",
          "description": "Loopback HTTP listening port."
        },
        {
          "name": "VAULT_MCP_GITHUB_OWNER",
          "isRequired": true,
          "description": "Owner of the operator-authorised vault repository."
        },
        {
          "name": "VAULT_MCP_GITHUB_REPO",
          "isRequired": true,
          "description": "Operator-authorised vault repository name."
        },
        {
          "name": "VAULT_MCP_POLICY_FILE",
          "isRequired": true,
          "description": "Absolute path to the operator-provisioned policy YAML."
        },
        {
          "name": "VAULT_MCP_TOKEN_FILE",
          "isRequired": true,
          "description": "Absolute path to the operator-provisioned client-token YAML."
        },
        {
          "name": "GITHUB_TOKEN",
          "isSecret": true,
          "description": "Required for the token-based quickstart. Alternatively configure all three GitHub App variables documented in README."
        },
        {
          "name": "GITHUB_APP_ID",
          "description": "GitHub App alternative: set all three App variables instead of GITHUB_TOKEN."
        },
        {
          "name": "GITHUB_APP_INSTALLATION_ID",
          "description": "GitHub App installation ID, required with GITHUB_APP_ID."
        },
        {
          "name": "GITHUB_APP_PRIVATE_KEY_FILE",
          "isSecret": true,
          "description": "Absolute path to the operator-provisioned App private key; required with GITHUB_APP_ID."
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/SarutobiSasuke8/obsidian-github-mcp",
    "source": "github"
  },
  "description": "A permissioned MCP gateway for agent proposals to a Git-backed Obsidian vault."
}