NotePlan MCP Server

Implementation Reference

• src/index.ts:16-29 (handler)

  MCP tool registration and inline handler for 'get_notes'. Fetches all notes from noteService.getAllNotes() and returns formatted JSON in MCP content structure.

    'get_notes',
    {},
    async () => {
      const notes = noteService.getAllNotes();
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify(notes, null, 2),
          },
        ],
      };
    }
  );

• src/services/noteService.ts:193-206 (helper)

  Core helper function getAllNotes() that implements note loading with caching from filesystem or mock data, called by the get_notes handler.

  function getAllNotes(): Note[] {
    const now = Date.now();
    
    // Use cache if still valid
    if (notesCache.length > 0 && (now - lastCacheUpdate) < CACHE_DURATION) {
      return notesCache;
    }
    
    // Refresh cache
    notesCache = loadNotesFromFileSystem();
    lastCacheUpdate = now;
    
    return notesCache;
  }

• src/services/noteService.ts:9-19 (schema)

  TypeScript interface defining the Note structure used in responses from get_notes tool.

  interface Note {
    id: string;
    title: string;
    content: string;
    created: string;
    modified: string;
    folder: string;
    filePath?: string;
    filename?: string;
    type?: string;
  }