Log inSubmit server
Hint Services Obsidian Github MCP logo

Hint Services Obsidian Github MCP

Read, search, and review GitHub-hosted Obsidian vaults through MCP tools for files, issues, and commit history.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Hint Services Obsidian Github MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "hint-services-obsidian-github-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-github-mcp"
      ],
      "env": {
        "GITHUB_TOKEN": "YOUR_VALUE_HERE",
        "GITHUB_OWNER": "YOUR_VALUE_HERE",
        "GITHUB_REPO": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

The install command started, but didn't respond the way we expected when we tried to talk to it.

npx -y obsidian-github-mcp

initialize succeeded but no response to tools/list.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 14d ago.

Overview

Hint-Services-obsidian-github-mcp MCP server connects MCP-compatible AI assistants to an Obsidian vault stored in a GitHub repository. It uses a GitHub token plus repository owner and name settings to retrieve files, search filenames, paths, and contents, and inspect related issues, discussions, and commit history. Reach for it when your notes, documentation, or research materials are versioned in GitHub and need to be accessed from an AI client.

Use cases

  • Retrieve project documentation from a GitHub-hosted vault
  • Search research notes by filename, path, or content
  • Review how notes changed over a selected period
  • Find GitHub issues and discussions related to a project

Key features

  • Read files from a GitHub-hosted Obsidian vault
  • Search filenames, paths, content, or all fields
  • Search GitHub issues and discussions
  • Inspect commit history with optional diffs
  • Validate tool inputs with Zod schemas

Tools8

What Hint Services Obsidian Github MCP lets your agent do. Expand a tool for its parameters.

Self-reported~135 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

21/21 checks healthy over the last 91d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 3d ago via OSV.dev · obsidian-github-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars10Stargazers on the source repository.
npm downloads77Package downloads in the last 30 days.
Last commit11mo agoMost recent push to the default branch.
Install checkInconclusiveStarted but did not complete the MCP handshake in our test.
Tools exposed8Callable tools this server registers over MCP.

How Hint Services Obsidian Github MCP works

What Hint-Services-obsidian-github-mcp does

Hint-Services-obsidian-github-mcp MCP server gives AI assistants access to Obsidian vaults held in GitHub repositories. It supports retrieving a specified file, locating files through several search scopes, searching GitHub issues and discussions, and reviewing changes made to the knowledge base over time.

The server is suited to vaults used for research notes, documentation, learning journals, project planning, and other Markdown-based knowledge collections. It can help an assistant find a relevant note before reading it, retrieve a known path directly, or examine recent repository history when the development of an idea matters.

How it works

The server communicates with GitHub using the repository owner, repository name, and a personal access token supplied through environment variables. MCP clients invoke the exposed tools and receive results from the configured repository. The repository can be public or private, subject to the permissions granted to the token.

File search supports four modes: filename, path, content, and all. The first targets file names, the second searches paths, the third searches text within files, and the last combines those areas. Search requests can also use GitHub-style query syntax, including path and extension filters, according to the examples in the project documentation.

Commit history requests can specify a time window and maximum number of commits. They may also request diffs, allowing an assistant to inspect both the sequence of changes and the associated content differences.

Setup and configuration

Install the npm package with npm install obsidian-github-mcp, or use the documented Smithery commands for Claude Desktop, Cursor, Windsurf, or Cline. A manual MCP configuration runs the package through npx -y obsidian-github-mcp.

Provide these required environment variables:

  • GITHUB_TOKEN: GitHub personal access token.
  • GITHUB_OWNER: Repository user or organization.
  • GITHUB_REPO: Repository containing the Obsidian vault.

For private repositories, the token needs the repo permission; public repositories require public_repo. Accessing organization repositories may also require read:org.

Tools and capabilities

Hint-Services-obsidian-github-mcp MCP server exposes four documented tools:

  • getFileContents retrieves a note, document, or other file at a specified path.
  • searchFiles searches by filename, path, content, or all three.
  • searchIssues finds issues and discussions connected to knowledge-base projects.
  • getCommitHistory returns repository change history and can include diffs.

The implementation is written in TypeScript, validates inputs with Zod schemas, and reports errors with informative messages, according to the project documentation.

Limitations and notes

The material describes access to GitHub-hosted repositories rather than a local Obsidian vault. Repository configuration and token permissions must therefore be correct before the tools can return data. The documented capabilities focus on retrieval, search, issue and discussion lookup, and history inspection; no note-editing or repository-writing tool is listed.

The README names Claude, Cursor, Windsurf, and Cline as supported MCP hosts and provides installation commands for them.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Hint Services Obsidian Github MCP

Hint-Services-obsidian-github-mcp is an MCP server that connects AI assistants to GitHub repositories containing Obsidian vaults. Its main tools retrieve file contents, search filenames, paths, and content, search related GitHub issues and discussions, and inspect commit history with optional diffs. It uses repository settings and a GitHub token.

Install it with `npm install obsidian-github-mcp`, then configure an MCP server that runs `npx -y obsidian-github-mcp`.

It requires `GITHUB_TOKEN`, `GITHUB_OWNER`, and `GITHUB_REPO`. These identify the GitHub credentials, repository owner or organization, and repository containing the Obsidian vault.

Yes, it can search note contents with the `searchFiles` tool using `searchIn: "content"`. The tool also supports filename, path, and combined searches, along with the documented GitHub-style path and extension query examples.

Related MCP servers

All in Knowledge & Memory All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewHint Services Obsidian Github MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/hint-services-obsidian-github-mcp?style=directory)](https://allmcps.com/mcp/hint-services-obsidian-github-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/hint-services-obsidian-github-mcp"><img src="https://allmcps.com/api/badge/hint-services-obsidian-github-mcp?style=directory" alt="Hint Services Obsidian Github MCP on AllMCPs" /></a>