Obsidian MCP Server

Instructions

Implementation Reference

• src/obsidian-handler.ts:56-68 (handler)

  The core handler function that executes the 'read_note' tool logic: validates the note path, checks file existence, and reads the file content from the Obsidian vault.

  async readNote(notePath: string): Promise<string> {
    if (!FileUtils.validatePath(this.config.vaultPath, notePath)) {
      throw new Error('無効なファイルパスです');
    }
  
    const fullPath = path.join(this.config.vaultPath, notePath);
    
    if (!(await FileUtils.fileExists(fullPath))) {
      throw new Error(`ノート '${notePath}' が見つかりません`);
    }
  
    return await fs.readFile(fullPath, 'utf-8');
  }

• src/server.ts:88-101 (registration)

  Registers the 'read_note' tool in the ListTools response, including name, description, and input schema.

  {
    name: 'read_note',
    description: 'Obsidianノートの内容を読み込みます',
    inputSchema: {
      type: 'object',
      properties: {
        notePath: {
          type: 'string',
          description: 'ノートのパス（vault相対パス）',
        },
      },
      required: ['notePath'],
    },
  },

• src/server.ts:281-285 (handler)

  The CallToolRequestSchema handler case that dispatches the 'read_note' tool call to the ObsidianHandler.readNote method and formats the response.

  case 'read_note':
    const noteContent = await this.obsidianHandler.readNote(args.notePath as string);
    return {
      content: [{ type: 'text', text: noteContent }],
    };