Knowledge Management · Developer Tools

Obsidian GitHub MCP

Hint-Services/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.

Install

npx -y obsidian-github-mcp

Client configuration

{
  "mcpServers": {
    "obsidianGithub": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-github-mcp"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>",
        "GITHUB_OWNER": "<GITHUB_OWNER>",
        "GITHUB_REPO": "<GITHUB_REPO>"
      }
    }
  }
}

Environment variables

GITHUB_TOKENGITHUB_OWNERGITHUB_REPO
Category
Knowledge Management, Developer Tools
Updated
Oct 6, 2026

Features

  • GitHub Repository Access: Connect to any GitHub repository containing your Obsidian vault

  • Type-Safe Implementation: Written in TypeScript with comprehensive type definitions

  • Input Validation: Robust validation for all API inputs using Zod schemas

  • Error Handling: Graceful error handling with informative messages

  • MCP Integration: Full compatibility with Claude, Cursor, Windsurf, Cline, and other MCP hosts

Tools (4)

  • getFileContents

    Retrieve the contents of specific notes, documents, or files from your Obsidian vault

  • searchFiles

    Enhanced search with multiple modes:

  • searchIssues

    Search for issues and discussions related to your knowledge base projects

  • getCommitHistory

    Track how your knowledge base has evolved over time with detailed commit history and diffs

Details on this page are taken from the project's README. Open README

Supported clients

Clients mentioned in this server's README:

View all
Claude Desktop logo

Claude Desktop

Desktop · Freemium · Proprietary

Anthropic's official Claude AI desktop application. Supports MCP servers to extend functionality.

WindowsMacOS
Cline logo

Cline

Desktop · Free · MIT

An AI coding assistant integrated into the IDE. Supports MCP servers for enhanced functionality.

WindowsMacOSLinux
Cursor logo

Cursor

Desktop · Freemium · Proprietary

The first agentic IDE. The Cursor editor truly merges how developers and AI work together, delivering a magical coding experience.

WindowsMacOSLinux
Windsurf logo

Windsurf

Desktop · Freemium · Proprietary

The first agentic IDE. The Windsurf editor truly merges how developers and AI work together.

WindowsMacOSLinux

Related MCP servers

More servers
MaxKB logo

MaxKB

1Panel-dev/MaxKB

16.2k

MaxKB = Max Knowledge Brain, it is an open-source platform for building enterprise-grade agents. MaxKB integrates Retrieval-Augmented Generation (RAG) pipelines, supports robust workflows, and provides advanced MCP tool-use capabilities.

Knowledge Management
UI-TARS-desktop logo

UI-TARS-desktop

bytedance/UI-TARS-desktop

12.9k

TARS is ByteDance's multimodal AI agent stack, shipping two projects: Agent TARS (a CLI and Web UI agent built on MCP) and UI-TARS-desktop (a desktop GUI agent).

Knowledge Management
Supermemory logo

Supermemory

supermemoryai/supermemory

9.4k

State-of-the-art memory and context engine for AI.

Knowledge Management
Cognee logo

Cognee

topoteretes/cognee

2.1k

Cognee - The Free Open-Source AI Memory Platform for Agents.

Knowledge Management
Notion MCP Server (Official) logo

Notion MCP Server (Official)

makenotion/notion-mcp-server

1.5k

For the best experience, use Remote Notion MCP, our official hosted MCP server. This repository is a separate, self-hosted MCP server implementation that is no longer actively maintained or supported. Please use Remote Notion MCP instead.

Knowledge Management
DevDocs logo

DevDocs

cyberagiinc/devdocs

1.4k

[!WARNING] DevDocs Status: Not publicly maintained. Enhanced internal version at CyberAGI — public release coming soon. If you have any questions please reach out to info@cyberagi.ai.

Knowledge Management