Obsidian GitHub MCP is an MCP server that connects AI assistants to Obsidian knowledge vaults hosted inside GitHub repositories. Designed for knowledge workers, developers, researchers, and students who back up or collaborate on Markdown notes via GitHub, the server provides direct programmatic access to repository-backed documentation. By exposing tools through the Model Context Protocol, it enables AI models to fetch raw file contents, inspect commit histories, analyze differences over time, and search for specific issues linked to knowledge projects. Users can execute multi-modal queries across exact filenames, specific file paths, and internal Markdown file contents to quickly isolate relevant contextual notes. Built in TypeScript with Zod-based input validation, Obsidian GitHub MCP acts as an information bridge, allowing external agents to query personal archives, study materials, and technical references directly inside supported environments like Claude Desktop, Cursor, Windsurf, or Cline without manually copying notes into chat windows.
Category: DevOps, CI/CD & Version Control
Tags: github, knowledge-management, markdown, obsidian, version control
repo scope for private repositories or public_repo for public repositories. 2. Install via Smithery for your preferred client, such as Claude Desktop: npx -y @smithery/cli install @Hint-Services/obsidian-github-mcp --client claude (or substitute --client cursor, windsurf, or cline). 3. Alternatively, manually add the server to your MCP configuration file: json { "mcpServers": { "obsidianGithub": { "command": "npx", "args": ["-y", "obsidian-github-mcp"], "env": { "GITHUB_TOKEN": "your-github-token", "GITHUB_OWNER": "your-github-username", "GITHUB_REPO": "your-obsidian-vault-repo" } } } } 4. Restart your MCP client to initialize the server tools.getFileContents tool to review specific dates. - Locating specific documentation: Run targeted filename searches with the searchFiles tool to find exact matching project files like roadmaps. - Scanning knowledge base contents: Perform deep content searches across stored Markdown files to gather research references on specific technical topics. - Tracking concept evolution: Inspect commit history and diff logs using getCommitHistory to analyze how personal notes evolved over time. - Connecting notes to tasks: Query GitHub issues using searchIssues to bridge project management workflows directly with related Obsidian documentation.Part of MCP Servers
You can install Obsidian GitHub MCP automatically using Smithery by running npx -y @smithery/cli install @Hint-Services/obsidian-github-mcp with your target client flag such as claude or cursor. You can also configure it manually in your client JSON configuration under mcpServers using npx -y obsidian-github-mcp while providing GITHUB_TOKEN, GITHUB_OWNER, and GITHUB_REPO environment variables.
The server enables AI assistants to interact directly with an Obsidian vault hosted on GitHub. It can retrieve individual file contents, search files by path, filename, or content, review commit histories along with diffs to observe vault changes over time, and search repository issues connected to documentation projects.
Obsidian GitHub MCP is compatible with any standard Model Context Protocol client. Documented host environments include Claude Desktop, Cursor, Windsurf, and Cline, which can execute the server via npx or Smithery installation.
Your GitHub personal access token requires the repo permission if your Obsidian vault is stored in a private repository, or public_repo if stored in a public repository. If accessing a vault owned by an organization, the read:org permission is also needed.
Yes, Obsidian GitHub MCP is open-source software maintained by Hint Services. The source code, TypeScript implementation, and development guides are publicly accessible on GitHub.