NotePlan MCP Server

Implementation Reference

• src/index.ts:73-89 (registration)

  MCP server tool registration for 'get_notes_by_folder', including Zod input schema and thin wrapper handler delegating to noteService.getNotesByFolder.

  server.tool(
    'get_notes_by_folder',
    {
      folder: z.string().describe('The folder name to search in'),
    },
    async ({ folder }) => {
      const notes = noteService.getNotesByFolder(folder);
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify(notes, null, 2),
          },
        ],
      };
    }
  );

• src/services/noteService.ts:231-234 (handler)

  Core implementation of getNotesByFolder: filters the cached list of all notes by exact folder match or prefix (for subfolders).

  function getNotesByFolder(folder: string): Note[] {
    const notes = getAllNotes();
    return notes.filter(note => note.folder === folder || note.folder.startsWith(folder + '/'));
  }

• src/index.ts:75-77 (schema)

  Zod input schema for the tool, validating the 'folder' parameter as a string.

  {
    folder: z.string().describe('The folder name to search in'),
  },

• src/index.js:69-81 (registration)

  Alternative REST API endpoint registration/dispatch for getNotesByFolder command in the JS server implementation.

  case 'getNotesByFolder':
    if (!args.folder) {
      return res.status(400).json({ 
        error: 'Missing required parameter: folder', 
        status: 'error' 
      });
    }
      
    return res.json({ 
      result: noteService.getNotesByFolder(args.folder),
      status: 'success' 
    });