obsidian-docs-mcp 0.4.1

{
  "servers": {
    "obsidian-docs-mcp": {
      "type": "stdio",
      "command": "dnx",
      "args": ["obsidian-docs-mcp@0.4.1", "--yes"]
    }
  }
}
                    
This package contains an MCP Server. The server can be used in VS Code by copying the generated JSON to your VS Code workspace's .vscode/mcp.json settings file.
dotnet tool install --global obsidian-docs-mcp --version 0.4.1
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local obsidian-docs-mcp --version 0.4.1
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=obsidian-docs-mcp&version=0.4.1
                    
nuke :add-package obsidian-docs-mcp --version 0.4.1
                    

Obsidian Docs MCP

A Model Context Protocol (MCP) server, distributed as a .NET Global Tool, that gives AI agents fast, token-efficient search over the official Obsidian documentation:

  • Obsidian Developer Docs — the plugin/theme development manual (TypeScript API).
  • Obsidian Help — the end-user manual (settings, Markdown syntax, core plugins, etc.).

It combines SQLite FTS5 keyword search with local semantic embeddings (via Ollama) merged through Reciprocal Rank Fusion, so agents get the most relevant documentation snippets without burning context tokens.

Prerequisites

  • .NET 10 runtime is not required — this tool ships self-contained.
  • Ollama running locally with the nomic-embed-text model pulled:
    ollama pull nomic-embed-text
    

Install

dotnet tool install -g obsidian-docs-mcp

MCP Tools

Tool Description
SearchDocumentation(query, limit) Hybrid (keyword + semantic) search over the indexed Obsidian docs.
ReindexDocumentation() Downloads the latest docs from GitHub and rebuilds the local index.
IndexStatus() Returns the number of indexed documentation chunks.

Quick configuration

{
  "mcpServers": {
    "obsidian-docs-mcp": {
      "command": "obsidian-docs-mcp"
    }
  }
}
Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
0.4.1 183 7/12/2026
0.4.0 160 7/12/2026
0.3.3-beta 160 7/11/2026