Obsidian GitHub MCP connects AI assistants to Obsidian vaults stored on GitHub repositories. It enables AI models to read, search, and analyze Markdown-based knowledge bases stored in version control. Key features of Obsidian GitHub MCP: - Retrieve specific notes and documents from Obsidian vaults via GitHub's API. - Multi-mode file search across filenames, file paths, and document contents. - Track knowledge base evolution with Git commit history and diffs. - Search GitHub issues to integrate project management with notes. - Compatible with Claude, Cursor, Windsurf, Cline, and other MCP hosts. - Full TypeScript implementation with Zod schema validation.

[](https://smithery.ai/server/@Hint-Services/obsidian-github-mcp) [](https://www.npmjs.com/package/obsidian-github-mcp)

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:

Features

Available Tools

Knowledge Base Access

Project Management Integration

Use Cases

For Knowledge Workers

For Developers

For Students & Academics

Installation

Using Smithery (Recommended)

The easiest way to install Obsidian GitHub MCP is using Smithery:

# For Claude Desktop
npx -y @smithery/cli install @Hint-Services/obsidian-github-mcp --client claude
For Cursor
npx -y @smithery/cli install @Hint-Services/obsidian-github-mcp --client cursor
For Windsurf
npx -y @smithery/cli install @Hint-Services/obsidian-github-mcp --client windsurf
For Cline
npx -y @smithery/cli install @Hint-Services/obsidian-github-mcp --client cline

Manual Installation

npm install obsidian-github-mcp

Configuration

Add the server to your MCP settings file with the following configuration:

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

Required Environment Variables

GitHub Token Permissions

Your GitHub token needs the following permissions:

Example Workflows

Accessing Your Daily Notes

{
  "tool": "getFileContents",
  "arguments": {
    "filePath": "Daily Notes/2024-01-15.md"
  }
}

Finding Files by Name (Perfect for "OKR 2025" example!)

{
  "tool": "searchFiles",
  "arguments": {
    "query": "OKR 2025",
    "searchIn": "filename"
  }
}

Finding Files by Path

```json { "tool": "searchFiles", "arguments": { "query": "Daily Notes", "searchIn": "path"