Skip to content

Lesterhr/TaskWidget-for-Notion

Repository files navigation

TaskWidget for Notion

License: MIT

A minimal, always-on-top desktop widget that shows your Notion tasks as a floating sticky note. Built with Tauri v2 and React.

Disclaimer: This is an unofficial, community-built application. It is not affiliated with, endorsed by, or connected to Notion Labs, Inc. in any way.

Download

⬇ Windows Installer (.exe)

Screenshots

Notion Widget on Desktop

Task List    Deep Dive Timer    Timer Compact Mode

Settings    Notion Database

Features

  • Frameless, always-on-top floating window (like a sticky note)
  • Fetches tasks from any Notion database via the Notion API
  • Check off tasks, edit titles, add new tasks, and delete tasks — all synced to Notion
  • Filter tasks by a configurable "resistance" (priority/effort) column
  • Built-in focus timer (Pomodoro-style "Deep Dive" mode)
  • System tray icon with show/hide and quit
  • Window position remembered across restarts
  • Multi-profile support (switch between different databases)

Platform

Windows only — This app uses the Windows Credential Manager for secure API key storage and builds as an NSIS installer. Cross-platform support is not available at this time.

Security & Privacy

  • Your Notion API key is stored locally in the Windows Credential Manager — never in a config file, never in plain text.
  • The app only communicates with https://api.notion.com. No other network requests are made.
  • No telemetry, no analytics, no data collection of any kind.

Prerequisites

Setup

1. Get a Notion API Key

  1. Go to developers.notion.com and create a new integration
  2. Copy the Internal Integration Secret (starts with ntn_ or secret_)
  3. Share your target Notion database with the integration (click "..." on the database → "Connections" → add your integration)

2. Install & Run

# Clone the repository
git clone https://github.com/Lesterhr/Notion-Widget.git
cd Notion-Widget

# Install frontend dependencies
npm install

# Run in development mode
npm run tauri dev

# Build for production
npm run tauri build

3. Configure the App

On first launch, the settings screen will appear. Enter:

  • API Secret — your Notion integration token
  • Database ID — the 32-character ID from your Notion database URL

The app will auto-detect your database columns and let you map them to Title, Done, Resistance (priority), and Due Date.

Tech Stack

  • Frontend: React 19, TypeScript, Vite
  • Backend: Tauri v2, Rust
  • API Key Storage: Windows Credential Manager via keyring crate
  • Settings Storage: tauri-plugin-store (local JSON)
  • HTTP: tauri-plugin-http (bypasses CORS)

License

This project is licensed under the MIT License.

About

A lightweight Windows sticky note app that connects to your Notion workspace and keeps your tasks always visible on your desktop.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages