Obsidian Markdown Notes

Obsidian Markdown Notes

Read and search through your Obsidian vault or any directory containing Markdown notes

1,212
Stars
83
Forks
0
Releases

Overview

This MCP server enables Claude Desktop (or any MCP client) to access and query Markdown notes stored in a directory, with a focus on Obsidian vaults. By exposing a simple MCP interface, it lets you read the contents of Markdown files and search across your notes without leaving the MCP environment. The server runs via NPX and launches the mcp-obsidian CLI, taking a single input: the path to the Obsidian vault (or any folder containing Markdown notes). It supports installation through Smithery for automatic setup, or manual integration in VS Code using a JSON configuration that defines the vaultPath input and an obsidian server that executes npx mcp-obsidian <vaultPath>. The tool is designed to be lightweight and portable, leveraging standard Node tooling so you can run it without a global install. It is compatible with any directory of Markdown notes, making it useful beyond Obsidian for various note-taking workflows and enabling quick, context-rich querying via Claude or other MCP clients.

Details

Owner
calclavia
Language
JavaScript
License
GNU Affero General Public License v3.0
Updated
2025-12-07

Features

Read Markdown notes from a directory

Reads and exposes Markdown files from a user-specified path (e.g., Obsidian vault).

Search across notes

Enables quick searching across all Markdown files within the given vault or directory.

Obsidian vault compatibility

Optimized for Obsidian vault structure while supporting any Markdown directory.

MCP client integration

Designed to work with Claude Desktop and other MCP clients via the MCP protocol.

Smithery-based installation

Can be installed automatically using the Smithery CLI (npx ... install mcp-obsidian --client claude).

VS Code integration

Provides one-click install options for VS Code and optional JSON config for manual setup.

NPX-based deployment (no global install)

Runs mcp-obsidian via NPX, avoiding a global install.

JSON-based configuration

Includes a sample VS Code mcp.json for defining inputs and server commands.

Audience

Claude Desktop usersUsers can query and search Obsidian vaults via MCP with Claude Desktop.
MCP developersDevelopers integrate this server into MCP clients to access Markdown notes.
Obsidian enthusiastsPeople using Obsidian vaults can leverage MCP to search notes.

Tags

ObsidianMarkdownVaultSearchReadMCPClaude DesktopConnector