@mauricio.wolff/mcp-obsidian 0.5.5 → 0.6.0

package/README.md

@@ -6,9 +6,26 @@
 
 A universal AI bridge for Obsidian vaults using the Model Context Protocol (MCP) standard. Connect any MCP-compatible AI assistant to your knowledge base - works with Claude, ChatGPT, and future AI tools. This server provides safe read/write access to your notes while preventing YAML frontmatter corruption.
 
-🌐 **Website:** [mcp-obsidian.org](https://mcp-obsidian.org)
+<div align="center">
+  
+[https://mcp-obsidian.org](https://mcp-obsidian.org)
+
+</div>
+
+<div align="center">
+
+[![GitHub Stars](https://img.shields.io/github/stars/bitbonsai/mcp-obsidian?style=flat&logo=github&logoColor=white&color=9065ea&labelColor=262626)](https://github.com/bitbonsai/mcp-obsidian) 
+[![GitHub Sponsors](https://img.shields.io/github/sponsors/BitBonsai?style=flat&logo=github&logoColor=white&color=9065ea&labelColor=262626)](https://github.com/sponsors/bitbonsai) 
+[![GitHub Sponsors](https://img.shields.io/github/sponsors/BitBonsai?style=flat&logo=github&logoColor=white&color=9065ea&labelColor=262626)](https://github.com/sponsors/bitbonsai) 
+[![Ko-Fi](https://img.shields.io/badge/Ko--fi-Support%20Me-9065ea?style=flat&logo=ko-fi&logoColor=white&labelColor=262626)](https://ko-fi.com/bitbonsai) 
+[![Liberapay](https://img.shields.io/badge/Liberapay-Weekly%20Support-9065ea?style=flat&logo=liberapay&logoColor=white&labelColor=262626)](https://liberapay.com/bitbonsai/)
+
+</div>
 
-**Universal Compatibility:** Works with any MCP-compatible AI assistant including Claude Desktop, Claude Code, ChatGPT Desktop (Enterprise+), IntelliJ IDEA 2025.1+, Cursor IDE, Windsurf IDE, and future AI platforms that adopt the MCP standard.
+
+
+## Universal Compatibility
+Works with any MCP-compatible AI assistant including Claude Desktop, Claude Code, ChatGPT Desktop (Enterprise+), IntelliJ IDEA 2025.1+, Cursor IDE, Windsurf IDE, and future AI platforms that adopt the MCP standard.
 
 https://github.com/user-attachments/assets/657ac4c6-1cd2-4cc3-829f-fd095a32f71c
 
@@ -242,6 +259,14 @@ Edit `.claude.json` in your project or add to the projects section:
 claude mcp add obsidian --scope user npx @mauricio.wolff/mcp-obsidian /path/to/your/vault
 ```
 
+#### Goose Desktop
+
+On Goose Desktop settings, click **Add custom extension**, and on the command field add:
+
+```bash
+npx @mauricio.wolff/mcp-obsidian@latest /path/to/your/vault
+```
+
 #### Other MCP-Compatible Clients (2025)
 
 **Confirmed MCP Support:**

package/dist/server.js

@@ -18,7 +18,7 @@ const fileSystem = new FileSystemService(vaultPath, pathFilter, frontmatterHandl
 const searchService = new SearchService(vaultPath, pathFilter);
 const server = new Server({
     name: "mcp-obsidian",
-    version: "0.5.4"
+    version: "0.6.0"
 }, {
     capabilities: {
         tools: {},
@@ -69,6 +69,33 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                     required: ["path", "content"]
                 }
             },
+            {
+                name: "patch_note",
+                description: "Efficiently update part of a note by replacing a specific string. This is more efficient than rewriting the entire note for small changes.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        path: {
+                            type: "string",
+                            description: "Path to the note relative to vault root"
+                        },
+                        oldString: {
+                            type: "string",
+                            description: "The exact string to replace. Must match exactly including whitespace and line breaks."
+                        },
+                        newString: {
+                            type: "string",
+                            description: "The new string to insert in place of oldString"
+                        },
+                        replaceAll: {
+                            type: "boolean",
+                            description: "If true, replace all occurrences. If false (default), the operation will fail if multiple matches are found to prevent unintended replacements.",
+                            default: false
+                        }
+                    },
+                    required: ["path", "oldString", "newString"]
+                }
+            },
             {
                 name: "list_directory",
                 description: "List files and directories in the vault",
@@ -321,6 +348,23 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ]
                 };
             }
+            case "patch_note": {
+                const result = await fileSystem.patchNote({
+                    path: trimmedArgs.path,
+                    oldString: trimmedArgs.oldString,
+                    newString: trimmedArgs.newString,
+                    replaceAll: trimmedArgs.replaceAll
+                });
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2)
+                        }
+                    ],
+                    isError: !result.success
+                };
+            }
             case "list_directory": {
                 const listing = await fileSystem.listDirectory(trimmedArgs.path || '');
                 return {

package/dist/src/filesystem.js

@@ -129,6 +129,69 @@ export class FileSystemService {
             throw new Error(`Failed to write file: ${path} - ${error instanceof Error ? error.message : 'Unknown error'}`);
         }
     }
+    async patchNote(params) {
+        const { path, oldString, newString, replaceAll = false } = params;
+        if (!this.pathFilter.isAllowed(path)) {
+            return {
+                success: false,
+                path,
+                message: `Access denied: ${path}`
+            };
+        }
+        // Validate that oldString and newString are different
+        if (oldString === newString) {
+            return {
+                success: false,
+                path,
+                message: 'oldString and newString must be different'
+            };
+        }
+        try {
+            // Read the existing note
+            const note = await this.readNote(path);
+            // Get the full content with frontmatter
+            const fullContent = note.originalContent;
+            // Count occurrences of oldString
+            const occurrences = fullContent.split(oldString).length - 1;
+            if (occurrences === 0) {
+                return {
+                    success: false,
+                    path,
+                    message: `String not found in note: "${oldString.substring(0, 50)}${oldString.length > 50 ? '...' : ''}"`,
+                    matchCount: 0
+                };
+            }
+            // If not replaceAll and multiple occurrences exist, fail
+            if (!replaceAll && occurrences > 1) {
+                return {
+                    success: false,
+                    path,
+                    message: `Found ${occurrences} occurrences of the string. Use replaceAll=true to replace all occurrences, or provide a more specific string to match exactly one occurrence.`,
+                    matchCount: occurrences
+                };
+            }
+            // Perform the replacement
+            const updatedContent = replaceAll
+                ? fullContent.split(oldString).join(newString)
+                : fullContent.replace(oldString, newString);
+            // Write the updated content
+            const fullPath = this.resolvePath(path);
+            await writeFile(fullPath, updatedContent, 'utf-8');
+            return {
+                success: true,
+                path,
+                message: `Successfully replaced ${replaceAll ? occurrences : 1} occurrence${occurrences > 1 ? 's' : ''}`,
+                matchCount: occurrences
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                path,
+                message: `Failed to patch note: ${error instanceof Error ? error.message : 'Unknown error'}`
+            };
+        }
+    }
     async listDirectory(path = '') {
         // Normalize path: treat '.' as root directory
         const normalizedPath = path === '.' ? '' : path;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mauricio.wolff/mcp-obsidian",
-  "version": "0.5.5",
+  "version": "0.6.0",
   "description": "Universal AI bridge for Obsidian vaults - connect any MCP-compatible assistant",
   "author": "bitbonsai",
   "license": "MIT",