MCP Notes

Instructions

Implementation Reference

• src/tools/filesystem.ts:212-242 (handler)

  The handler function that executes the read_note tool logic: validates args, constructs file path, reads file content, handles errors.
  export async function handleReadNote(notesPath: string, args: ReadNoteArgs): Promise<ToolCallResult> { try { // Validate path is provided if (!args.path) { throw new Error("'path' parameter is required"); } const filePath = path.join(notesPath, args.path); // Ensure the path is within allowed directory if (!filePath.startsWith(notesPath)) { throw new Error("Access denied - path outside notes directory"); } try { const content = await fs.readFile(filePath, 'utf-8'); return { content: [{ type: "text", text: content }] }; } catch (error) { const errorMessage = error instanceof Error ? error.message : String(error); throw new Error(`Error reading file: ${errorMessage}`); } } catch (error) { const errorMessage = error instanceof Error ? error.message : String(error); return { content: [{ type: "text", text: `Error reading note: ${errorMessage}` }], isError: true }; }
• src/tools/filesystem.ts:68-82 (schema)

  Tool definition including name, description, and input schema for read_note
  { name: "read_note", description: "Read the complete contents of a note file from your notes directory. " + "Specify the path relative to your notes directory (e.g., 'Log/2023-01-01.md'). " + "Returns the full text content of the note file.", inputSchema: { type: "object", properties: { path: { type: "string", description: "The path to the note file, relative to your notes directory" } }, required: ["path"] },
• src/tools/filesystem.ts:27-29 (schema)

  Type definition for the input arguments of read_note
  interface ReadNoteArgs { path: string; }
• src/tools/index.ts:351-352 (registration)

  Dispatch/registration of read_note handler in the main tool call switch statement
  case "read_note": return await handleReadNote(notesPath, args);
• src/tools/index.ts:9-17 (registration)

  Import of handleReadNote and tool definitions from filesystem module
  ensureDirectory, initializeNotesDirectory, handleSearchFiles, handleReadNote, handleReadMultipleNotes, handleListDirectory, handleCreateDirectory, getFilesystemToolDefinitions } from './filesystem.js';