move_note
Relocate or rename notes within your Obsidian vault by specifying source and destination paths to reorganize your knowledge base.
Instructions
Move or rename a note to a new location in the Obsidian vault
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sourcePath | Yes | Current path to the note within the vault | |
| destinationPath | Yes | New path where the note should be moved |
Implementation Reference
- src/index.ts:1511-1526 (handler)The MCP tool handler for 'move_note'. Validates input arguments and delegates to the moveNote method, then returns success message.private async handleMoveNote(args: any) { if (!args?.sourcePath || !args?.destinationPath) { throw new Error('Source path and destination path are required'); } await this.moveNote(args.sourcePath, args.destinationPath); return { content: [ { type: 'text', text: `Note moved successfully from ${args.sourcePath} to ${args.destinationPath}`, }, ], }; }
- src/index.ts:2393-2450 (helper)Core implementation of moving/renaming a note. Attempts Obsidian API operations (read+create+delete) first, falls back to filesystem renameSync with directory creation and cleanup.private async moveNote(sourcePath: string, destinationPath: string): Promise<void> { try { // First try using the Obsidian API - using standard file operations // Most Obsidian Local REST API implementations don't support direct move operations // So we'll read the source file and create it at the destination, then delete the source // Read source file content via API const sourceResponse = await this.api.get(`/vault/${encodeURIComponent(sourcePath)}`); const content = sourceResponse.data.content || ''; // Create destination file via API await this.api.post(`/vault/${encodeURIComponent(destinationPath)}`, { content }); // Delete source file via API await this.api.delete(`/vault/${encodeURIComponent(sourcePath)}`); } catch (error) { // Fallback to file system operations const sourceFullPath = path.join(VAULT_PATH, sourcePath); const destFullPath = path.join(VAULT_PATH, destinationPath); // Validate source file exists if (!fs.existsSync(sourceFullPath)) { throw new Error(`Source note not found: ${sourcePath}`); } // Check if destination already exists if (fs.existsSync(destFullPath)) { throw new Error(`Destination already exists: ${destinationPath}`); } // Create destination directory if it doesn't exist const destDir = path.dirname(destFullPath); if (!fs.existsSync(destDir)) { fs.mkdirSync(destDir, { recursive: true }); } // Use filesystem rename (works for all file types including PDF) try { fs.renameSync(sourceFullPath, destFullPath); } catch (renameError) { throw new Error(`Failed to move file: ${renameError}`); } // Clean up empty source directory if needed const sourceDir = path.dirname(sourceFullPath); if (sourceDir !== VAULT_PATH) { try { const items = fs.readdirSync(sourceDir); if (items.length === 0) { fs.rmdirSync(sourceDir); } } catch (error) { // Ignore errors when cleaning up empty directories } } } }
- src/index.ts:1178-1194 (schema)Input schema definition for the move_note tool, specifying sourcePath and destinationPath as required string parameters.name: 'move_note', description: 'Move or rename a note to a new location in the Obsidian vault', inputSchema: { type: 'object', properties: { sourcePath: { type: 'string', description: 'Current path to the note within the vault', }, destinationPath: { type: 'string', description: 'New path where the note should be moved', }, }, required: ['sourcePath', 'destinationPath'], }, },
- src/index.ts:1399-1400 (registration)Registration of the move_note tool handler in the CallToolRequestSchema switch statement.return await this.handleMoveNote(request.params.arguments); case 'manage_folder':