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';