https://github.com/hslcrb/jsonote
The Ultimate JSON-based Note-taking Application with GitHub Integration & MCP Support.
https://github.com/hslcrb/jsonote
github-sync glassmorphism json mcp nextjs note-taking
Last synced: 5 days ago
JSON representation
The Ultimate JSON-based Note-taking Application with GitHub Integration & MCP Support.
- Host: GitHub
- URL: https://github.com/hslcrb/jsonote
- Owner: hslcrb
- License: apache-2.0
- Created: 2026-01-17T07:01:09.000Z (7 days ago)
- Default Branch: main
- Last Pushed: 2026-01-17T16:20:06.000Z (7 days ago)
- Last Synced: 2026-01-17T18:14:24.830Z (7 days ago)
- Topics: github-sync, glassmorphism, json, mcp, nextjs, note-taking
- Language: TypeScript
- Homepage: https://rheehose.com
- Size: 710 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: docs/SECURITY.md
Awesome Lists containing this project
README
# JSONOTE (v1.0)
[](./README_ko.md)
[](https://github.com/hslcrb/jsonote/releases/latest)
[](https://opensource.org/licenses/Apache-2.0)
[](https://github.com/hslcrb/jsonote/actions)
[](https://github.com/hslcrb/jsonote/releases/latest)
[](https://github.com/hslcrb/jsonote/pkgs/container/jsonote)
> **The Ultimate JSON-based Note-taking Application with GitHub Integration & MCP Support.**
**Official First Release: Monday, January 19, 2026 (KST)**
---
## 🛠️ Installation & Setup (How to Start)
### 1. 💻 Desktop App (Windows, Mac, Linux) - **Recommended**
Download the official standalone client from our [Releases Page](../../releases).
- **Windows**: `JSONOTE-Setup-1.0.exe` (Installer) or `.zip` (Portable)
- **Mac**: `JSONOTE-1.0.dmg` (Installer) or `.zip` (App Bundle)
- **Linux**: `JSONOTE-1.0.AppImage` (Executable) or `.zip`
### 2. 🐳 Docker (GitHub Container Registry)
Run the application instantly using Docker:
```bash
docker pull ghcr.io/hslcrb/jsonote:latest
docker run -p 3000:3000 ghcr.io/hslcrb/jsonote:latest
```
Access the app at `http://localhost:3000`.
### 3. 🏗️ Build from Source (Developers)
Requires Node.js **v20.9.0** or higher.
```bash
git clone https://github.com/hslcrb/jsonote.git
cd jsonote
npm install
npm run build
npm run start
```
---
## 🚀 Key Features
### 1. GitHub Native Synchronization
- Your notes are stored as `.json` files in your private GitHub repository.
- Full version control through Git.
- Real-time sync with **visual feedback** (Saving... -> Saved!).
### 2. Notion-Inspired Workspace
- **Infinite Hierarchy**: Nest pages within pages to build a knowledge base.
- **Database Views**: Switch between **List**, **Table**, and **Board** views.
- **Custom Properties**: Add metadata fields (Text, Number, Date, etc.) to any note.
### 3. MCP (Model Context Protocol) Integration
- Connect to external AI tools (Notion, GitHub, etc.) directly within the editor.
### 4. Developer-Friendly UI
- **Glassmorphism Design**: Premium obsidian-dark aesthetic.
- **Markdown Support**: Syntax highlighting, standard URL images, and easy formatting.
---
## ⚙️ Post-Installation Setup
1. Open **Settings** in the app.
2. Enter your **GitHub Personal Access Token** (Repo permissions required).
3. Specify your `Owner`, `Repo`, and `Branch`.
4. Click **Test Connection (연결 진단)** to verify.
5. Everything is ready! Your notes will sync automatically.
---
## 📝 Documentations
- 📘 [Getting Started Guide](./docs/GUIDE.md)
- ⚙️ [MCP Setup Guide](./docs/MCP_SETUP.md)
- 🛡️ [Security & Privacy](./docs/SECURITY.md)
- 🤝 [Contributing Guide](./CONTRIBUTING.md)
---
## ⚖️ License
Licensed under the **Apache License 2.0**.
Copyright 2008-2026 Rheehose (Rhee Creative). All rights reserved.