From 82d2409fe3e5341ce719f53ad4c57d01b3ecf486 Mon Sep 17 00:00:00 2001 From: "Peter.Morton" Date: Thu, 16 Apr 2026 09:22:57 -0500 Subject: [PATCH] docs: clarify Obsidian must be running before using MCP tools (fixes #4) - Add prominent note in Prerequisites that Obsidian must be open and running - Expand Troubleshooting section with explanation of why the error occurs and how to fix it Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- README.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 09ccb30..f2915cd 100644 --- a/README.md +++ b/README.md @@ -19,7 +19,9 @@ An MCP (Model Context Protocol) Bundle that exposes Obsidian CLI capabilities to - Node.js >= 18.0.0 - Obsidian CLI installed and configured -- Obsidian application installed +- Obsidian application installed and **running** + +> **Important:** The Obsidian application must be open and running before using any MCP tools. The CLI used by this bundle communicates with the running Obsidian instance. If Obsidian is not running, commands will launch the GUI instead of executing — start Obsidian first, then use the MCP tools. ### Install via Claude Desktop @@ -194,7 +196,9 @@ Contributions are welcome! Please ensure: ### "Obsidian not running" error -Start the Obsidian application before using MCP tools. +The Obsidian application must be running before using any MCP tools. The CLI communicates with the running Obsidian instance — if Obsidian is closed, commands will launch the GUI app instead of executing. + +**Fix:** Open the Obsidian application and wait for it to fully load, then retry the operation. ### "Vault not found" error