Obsidian GitHub MCP

Name: Obsidian GitHub MCP
Author: SarutobiSasuke8

by SarutobiSasuke8version 0.1.0i★ –iRuns on your computer

Registry nameio.github.SarutobiSasuke8/obsidian-github-mcp

Install

Overview

Description from the maker (original English)

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

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: Streamable HTTP
Category: Docs, sheets & office work
You need to fill in: VAULT_MCP_GITHUB_OWNER, VAULT_MCP_GITHUB_REPO, VAULT_MCP_POLICY_FILE, VAULT_MCP_TOKEN_FILE, GITHUB_TOKEN, GITHUB_APP_PRIVATE_KEY_FILE

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: 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

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "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"
      }
    }
  }
}

Run this in your terminal

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

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "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"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "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"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

VAULT_MCP_PORT env
Loopback HTTP listening port.
VAULT_MCP_GITHUB_OWNER required env
Owner of the operator-authorised vault repository.
VAULT_MCP_GITHUB_REPO required env
Operator-authorised vault repository name.
VAULT_MCP_POLICY_FILE required env
Absolute path to the operator-provisioned policy YAML.
VAULT_MCP_TOKEN_FILE required env
Absolute path to the operator-provisioned client-token YAML.
GITHUB_TOKEN secret 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 secret env
Absolute path to the operator-provisioned App private key; required with GITHUB_APP_ID.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account SarutobiSasuke8, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Docs, sheets & office worki

More stars than 0% of the other 2191 servers in this category
Published to the registry more recently than 70% of the other 2191 servers in this category
Basic checks equal to or better than 100% of the other 2191 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Obsidian GitHub MCP safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: VAULT_MCP_GITHUB_OWNER, VAULT_MCP_GITHUB_REPO, VAULT_MCP_POLICY_FILE, VAULT_MCP_TOKEN_FILE, GITHUB_TOKEN, GITHUB_APP_PRIVATE_KEY_FILE

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.1.0) reached the registry 13 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: Agent-Native Calendar, Excel MCP Server, MCP Server for Excel

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Agent-Native Calendar

by BuilderIO

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

Runs in the cloud★ 7,620MITUpdated 2 months ago

Install

Excel MCP Server

by haris-musa

Lets AI create and edit Excel files itself, including formulas, charts and PivotTables, without Excel installed.

Runs on your computer★ 4,276MITUpdated 6 days ago

Install

MCP Server for Excel

by sbroenne

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

Runs on your computer★ 847MITUpdated 3 days ago

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

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

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Docs, sheets & office worki

Common questions

Alternatives

Agent-Native Calendar

Excel MCP Server

MCP Server for Excel

README from the maker

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