NeatNote / README.md
nharshavardhana's picture
commit
8114db0
---
title: NeatNote
emoji: πŸŒ–
colorFrom: pink
colorTo: green
sdk: gradio
sdk_version: 5.49.1
app_file: app.py
pinned: false
license: mit
short_description: MCP server converts scattered notes into structured meaning
tags:
- building-mcp-track-consumer
---
# πŸš€ NeatNote β€” Turn Messy Notes Into Clear, Organized Insights
## ✨ AI-powered semantic clustering, summarization, and export engine β€” built with Claude MCP + Gradio
### NeatNote is an AI tool that transforms unstructured text into clean, structured knowledge using a combination of:
* Semantic embeddings (Sentence Transformers)
* Density-based clustering (HDBSCAN)
* LLM-based cluster titling + summarization
* Beautiful Markdown + HTML export
* Fully controllable through Claude via MCP tools
Whether you're collecting research notes, meeting minutes, chaotic brain dumps, or text files full of ideas β€” NeatNote organizes everything automatically into meaningful clusters with summaries to help you understand your information faster.
---
### πŸ”₯ Why NeatNote?
Everyone has messy notes. **The problem is not collecting information, but making sense of it**.
NeatNote solves this by:
* Extracting the semantic meaning of your notes
* Grouping related ideas automatically
* Naming clusters intelligently with LLM summaries
* Exporting polished results
* Allowing full automation via Claude MCP for end-to-end workflows
This makes it perfect for:
* Students
* Researchers
* Founders
* Writers
* Productivity lovers
* Anyone with text chaos πŸš€
---
### 🧭 Architecture Overview
Here's how it is structured:
![Architecture Diagram](./Architecture_NeatNote.png)
---
### πŸ“Ί Demo Video
πŸŽ₯ [Watch the Demo on YouTube](https://youtu.be/6d8Drbmn0-s?si=fk716CYMBnIpLKME)
---
### 🌐 Social Media Post
πŸ“Œ [X Link](https://x.com/nharshav/status/1991394479933387101?s=20)
---