gamosoft/NoteDiscovery

What is it?

Key features

• 01Stores notes as plain markdown files in folders
• 02Full-text search, tags, and favorites
• 03Graph view of linked notes and backlinks
• 04LaTeX/MathJax math and Mermaid diagrams
• 05Built-in drawing editor saving PNG files alongside notes
• 06Built-in MCP server for AI assistants like Claude and Cursor
• 07Optional password protection and HTML export

Use cases

• Keeping a personal wiki or second brain on a home server
• Writing developer notes in markdown with local file storage
• Running a private note system without sending data to cloud services
• Letting an AI assistant read and organize your notes through MCP

Quick start

1. 1

   Create a data folder and run the Docker container (Linux/macOS)

   mkdir -p notediscovery/data && cd notediscovery docker run -d --name notediscovery -p 8000:8000 -v $(pwd)/data:/app/data ghcr.io/gamosoft/notediscovery:latest
2. 2

   Open http://localhost:8000 in your browser

Things to know

• !Security guidance says not to expose it directly to the internet without extra measures.
• !Running it without Docker requires Python 3.8 or higher and pip.

In collections

Topics

FAQ

What is NoteDiscovery?

A lightweight, self-hosted note-taking app that stores notes as plain markdown files on your own server. NoteDiscovery is a self-hosted note-taking application built around plain markdown files stored in a local data folder. You run it on your own machine or server, usually via Docker, and access it through a web browser. Notes can be organized into folders, tagged, searched in full text, and linked to each other with a graph view showing connections.

Is NoteDiscovery free to use? What license does it have?

NoteDiscovery is open source under the MIT license. Check the license terms before using it in commercial products.

Is NoteDiscovery still maintained?

Actively maintained. The last commit to NoteDiscovery was on Oct 23, 2026.

What can I use NoteDiscovery for?

Keeping a personal wiki or second brain on a home server Writing developer notes in markdown with local file storage Running a private note system without sending data to cloud services Letting an AI assistant read and organize your notes through MCP

How do I install NoteDiscovery?

Create a data folder and run the Docker container (Linux/macOS): mkdir -p notediscovery/data && cd notediscovery docker run -d --name notediscovery -p 8000:8000 -v $(pwd)/data:/app/data ghcr.io/gamosoft/notediscovery:latest Open http://localhost:8000 in your browser

Where can I get NoteDiscovery?

The source code and installation instructions are on GitHub: https://github.com/gamosoft/NoteDiscovery