Claude MarketplacesSubmit
hint-services avatar

Hint Services Obsidian Github Mcp

hint-services/obsidian-github-mcp

If you keep your Obsidian vault in a GitHub repo, this server lets Claude read and search through it directly. You get getFileContents for pulling specific notes, searchFiles with modes for filename, path, content, or all three at once, and getCommitHistory to see how notes evolved. It also surfaces searchIssues for GitHub integration. The filename search mode is handy when you need something specific like "OKR 2025.md" without wading through content matches. Needs a GitHub token with repo access and your owner/repo details in the config. Written in TypeScript with Zod validation throughout.

GitHub stars
9
tools
4
auth
Secret needed
transport
HTTP
last updated
Sep 14, 2025
View on GitHub

Tools

4 tools

Public tool metadata for what this MCP can expose to an agent.

getFileContentsRetrieve the contents of a specific note, document, or file from your Obsidian vault stored in GitHub (hoffination/Ben-Personal). Perfect for accessing your knowledge base content.1 params

Retrieve the contents of a specific note, document, or file from your Obsidian vault stored in GitHub (hoffination/Ben-Personal). Perfect for accessing your knowledge base content.

Parameters* required
filePathstring
Path to the file within the repository.
searchFilesSearch for notes, documents, and files within your Obsidian vault on GitHub (hoffination/Ben-Personal). Find specific knowledge base content using GitHub's powerful search syntax. Supports searching in filenames, paths, and content.4 params

Search for notes, documents, and files within your Obsidian vault on GitHub (hoffination/Ben-Personal). Find specific knowledge base content using GitHub's powerful search syntax. Supports searching in filenames, paths, and content.

Parameters* required
pagenumber
Page number to retrieve (0-indexed)default: 0
perPagenumber
Number of results per pagedefault: 100
querystring
Search query - can be a simple term or use GitHub search qualifiers
searchInstring
Where to search: 'filename' (exact filename match), 'path' (anywhere in file path), 'content' (file contents), or 'all' (comprehensive search)one of filename · path · content · alldefault: all
searchIssuesSearch for issues and discussions in your Obsidian vault repository (hoffination/Ben-Personal). Great for tracking tasks, project management, and collaborative knowledge work.1 params

Search for issues and discussions in your Obsidian vault repository (hoffination/Ben-Personal). Great for tracking tasks, project management, and collaborative knowledge work.

Parameters* required
querystring
Search query (uses GitHub Issue Search syntax)
getCommitHistoryTrack the evolution of your Obsidian vault knowledge base by retrieving commit history from GitHub (hoffination/Ben-Personal). See how your notes and ideas have developed over time with detailed diffs.5 params

Track the evolution of your Obsidian vault knowledge base by retrieving commit history from GitHub (hoffination/Ben-Personal). See how your notes and ideas have developed over time with detailed diffs.

Parameters* required
authorstring
Filter commits by author username
daysnumber
Number of days to look back for commits
includeDiffsboolean
Whether to include actual file changes/diffs (default: true)default: true
maxCommitsnumber
Maximum number of commits to returndefault: 25
pagenumber
Page number for pagination (0-indexed)default: 0

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Readme

smithery badge npm version

Obsidian GitHub MCP

A Model Context Protocol (MCP) server that connects AI assistants to GitHub repositories containing Obsidian vaults. This server enables seamless integration with your knowledge base stored on GitHub, allowing AI assistants to read, search, and analyze your Obsidian notes and documentation.

Why This Tool?

Many Obsidian users store their vaults in GitHub for backup, versioning, and collaboration. This MCP server bridges the gap between your GitHub-hosted Obsidian vault and AI assistants, enabling:

  • Knowledge Base Access: Retrieve specific notes and documents from your Obsidian vault
  • Intelligent Search: Find relevant content across your entire knowledge base
  • Evolution Tracking: See how your ideas and notes have developed over time
  • Task Integration: Connect with issues and project management workflows

Features

View the full README on GitHub

Details

Repository
github.com/hint-services/obsidian-github-mcp
Categories
Developer Tools, Documents & Knowledge, Search & Web Crawling
Transport
HTTP
Auth
Required
Registry
MCP registry, active

Related Developer Tools MCP servers

View all
1dubuqingfeng avatarGitlab Mcp Serverdubuqingfeng/gitlab-mcp-serverGitLab MCP (Model Context Protocol) server for AI agents9stars
2wei avatarMymlh Mcp Serverwei/mymlh-mcp-serverOAuth-enabled MyMLH MCP server for accessing MyMLH data.9stars
3structured-world avatarAdvanced GitLab MCP serverstructured-world/gitlab-mcp66 tools, 242 typed actions, 27 registry groups8stars
4paarths-collab avatarGitHub PR Contextpaarths-collab/github-pr-context-mcpRetrieves GitHub PR history as context material; the connected IDE agent does the reasoning.7stars
5ratamaha-git avatarN8n Mcpratamaha-git/n8n-mcpMCP server for n8n: generate, lint, explain failed executions, drive live n8n via REST.7stars
6snyk avatarSnyk API & Web MCP Serversnyk/saw-mcpMCP server for Snyk API & Web — DAST scanning, findings management, and vulnerability triage7stars