OSS Tanbou
View on GitHub

itsnotes — A self-hosted Keep-style notes app with a two-way Markdown mirror, REST API, and MCP

OSS health 83
About these scores

Discovery score is an unbounded weighted, log-compressed index of stars, watchers, forks, and contributors. Growth momentum is its change over the observed period; OSS health is a 0–100 score from available repository recency, Community Health, and release data.

Stars
32
Primary language
JavaScript
License
MIT
Repository last updated
Sep 4, 2026

Overview

itsnotes keeps a Google Keep-style masonry workflow while adding folders, timeline markers, dense lists, Google Takeout and Obsidian imports, and a two-way Markdown mirror. It is built with React, Node.js, PostgreSQL, and Socket.IO, with a REST API, read-only MCP server, and optional AI through Ollama or cloud providers. The latest tagged release is 2026.9.0.

Features and best fit

Based on official documentation; not hands-on tested · Content checked:

Organize quick Keep-style notes with folders, timelines, and multiple views

Notes can be filtered through colors, tags, saved searches, and a calendar, while masonry, stacked, and dense list views cover different navigation styles. Google Keep Takeout, .txt/.md, and Obsidian vault imports are supported.

Sources: [2]

Keep PostgreSQL authoritative while mirroring notes bidirectionally to Markdown

Notes are continuously exported as Markdown with metadata, and edits made from tools such as Obsidian or VS Code can flow back into the database. Conflicts are preserved separately and renames are tracked by note ID, making the mirror useful for backups, grep, and Git workflows.

Sources: [2]

For people moving off Keep who still want Markdown files under their control

It fits users who want a fast web notes interface while keeping data in their own PostgreSQL/filesystem and retaining interoperability with Markdown editors such as Obsidian. REST and MCP also make it useful for personal automation.

Sources: [2]

It has only just started tagged releases, so pin versions and maintain backups

2026.9.0 is the first tagged release and marks the start of calendar versioning. Production deployments should prefer permanent image tags over latest, back up PostgreSQL, attachments, and the Markdown mirror, and read upgrade notes. Cloud AI providers can receive note content, unlike a fully local Ollama configuration.

Sources: [3][2]

Official sources

  1. [1]alexmicuplusfour/itsnotes — GitHub repository metadata(2026-09-17)
  2. [2]itsnotes — README(2026-09-17)
  3. [3]itsnotes 2026.9.0 release(2026-09-17)
Supplemental curator note

Treat it as a self-hosted notes workflow whose database remains authoritative while Markdown files can stay in sync, not merely as a Keep clone.

Try it in 3 steps

  1. 1

    Get the source

    git clone --depth 1 https://github.com/alexmicuplusfour/itsnotes.git
  2. 2

    Enter the repository

    cd itsnotes
  3. 3

    Check the official steps

    Continue with the commands in the README Installation, Quick Start, or Getting Started section.

    find . -maxdepth 1 -iname 'README*' -exec sed -n '1,220p' {} \; -quit
Check the official README

Growth

Growth trends · Last 30 days

32 Stars

Trend data is still being collected.

Development activity

Last 90 days · weekly

Commits (last 30 days)
18
Open PRs
0

Development activity is still being collected.

Built with

Categories and tags

Categories

Tags

GitHub data

GitHub dataView detailed GitHub data
View on GitHub

GitHub Topics

  • note-taking
  • notes
  • notes-app
  • google-keep
  • google-keep-alternative
  • google-keep-clone
  • obsidian
  • self-hosted
  • vibecoded
Stars
32
Forks
3
Watchers
1
Open issues
0
Primary language
JavaScript
License
MIT
Repository last updated
Sep 4, 2026
Write a related article

Share a guide or use case for this OSS in Markdown. Articles are published after administrator approval.

Report incorrect information

Tell us if any listing information is incorrect or outdated.