Obsidian MCP

Instructions

Implementation Reference

• src/index.ts:1118-1130 (registration)

  Tool registration in the ListToolsRequestSchema handler, including name, description, and input schema.

    name: 'delete_note',
    description: 'Delete a note from the Obsidian vault',
    inputSchema: {
      type: 'object',
      properties: {
        path: {
          type: 'string',
          description: 'Path to the note within the vault',
        },
      },
      required: ['path'],
    },
  },

• src/index.ts:1494-1509 (handler)

  MCP tool handler that validates input and calls the deleteNote implementation.

  private async handleDeleteNote(args: any) {
    if (!args?.path) {
      throw new Error('Path is required');
    }
    
    await this.deleteNote(args.path);
    
    return {
      content: [
        {
          type: 'text',
          text: `Note deleted successfully: ${args.path}`,
        },
      ],
    };
  }

• src/index.ts:2322-2347 (handler)

  Core implementation that deletes the note file using Obsidian REST API or direct filesystem unlink with directory cleanup.

  private async deleteNote(notePath: string): Promise<void> {
    try {
      // First try using the Obsidian API
      await this.api.delete(`/vault/${encodeURIComponent(notePath)}`);
    } catch (error) {
      console.warn('API request failed, falling back to file system:', error);
      
      // Fallback to file system if API fails
      const fullPath = path.join(VAULT_PATH, notePath);
      
      if (!fs.existsSync(fullPath)) {
        throw new Error(`Note not found: ${notePath}`);
      }
      
      fs.unlinkSync(fullPath);
      
      // Check if parent directory is empty and remove it if it is
      const dir = path.dirname(fullPath);
      if (dir !== VAULT_PATH) {
        const items = fs.readdirSync(dir);
        if (items.length === 0) {
          fs.rmdirSync(dir);
        }
      }
    }
  }

• src/index.ts:1396-1397 (registration)

  Dispatch registration in the CallToolRequestSchema switch statement.

  case 'delete_note':
    return await this.handleDeleteNote(request.params.arguments);

• src/index.ts:1121-1129 (schema)

  Input schema definition requiring a 'path' parameter.

    type: 'object',
    properties: {
      path: {
        type: 'string',
        description: 'Path to the note within the vault',
      },
    },
    required: ['path'],
  },