claudeers.
// MCP Servers

notchfolk

A living desktop notch: music with synced lyrics, tasks, reminders, calendar, AI agents (Hermes, Claude Code, Codex, OMP), a built-in MCP server, AI router a…

// MCP Servers[ cli ][ api ][ desktop ][ web ][ claude ]#claude#ai-agents#ai-gateway#claude-code#clipboard-manager#codex#dynamic-island#gnome#mcp-servers◷ GPL-3.0$open-sourceupdated 8 days ago

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up notchfolk (git-clone project) into my current project.
Found on https://claudeers.com/notchfolk
Repo: https://github.com/galyarderlabs/notchfolk
Homepage/docs: https://galyarderlabs.github.io/notchfolk/
Detected install method: git-clone → git clone https://github.com/galyarderlabs/notchfolk
Category: mcp-servers. Platforms: cli, api, desktop, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or clone
git clone https://github.com/galyarderlabs/notchfolk

// compatibility

Platformscli, api, desktop, web
Operating systems—
AI compatibilityclaude
LicenseGPL-3.0
Pricingopen-source
LanguageRust

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

Notchfolk — a little world in your notch

Your desktop notch, alive — GNOME today, Windows and macOS next. Music with synced lyrics, calls, a focus timer, calendar, food and water tracking, prayer times, weather, a file shelf, app usage, phone integration, and AI agents (Hermes, Claude Code, Grok, Codex, OMP) through a built-in MCP server — with AI router analytics and subscription usage quota tracking.

Notchfolk turns the centre of the top bar into a black notch. At rest, the clock sits in the middle with what's running beside it — a song, a call, a timer. Rest the pointer on it and it springs open into a small panel with tabs for each page.

Features

Music page: Little Dark Age by MGMT at 2:08
Music. Spotify, YouTube in your browser, or any MPRIS player: cover, scrubber and controls, with the playing app's icon on the cover. Volume and output switching one click away.
Synced lyrics: the line being sung large and bright, Little Dark Age by MGMT
Synced lyrics from LRCLIB: the line being sung large and bright, pauses as breathing dots; click a line to jump. The island widens and takes the cover's colour.
A Telegram voice call in the island: 0:08, with Mute and Open
Calls in WhatsApp, Telegram, Zoom, Meet and other call apps, or call pages in a browser: a green phone in the closed island, the call's length on the Call page. Open it to watch live while you work elsewhere, mute, or jump back to the call.
Timer page: the ring at 40:42, Work 60 and Break 15, with Pause
Timer. A Pomodoro timer with breaks and Do Not Disturb while you focus: a ring with the time left, work and break lengths to type or step with − and + (locked from Start until Reset). Its time left stays in the closed island; beside a song or a call it shows as a small ring.
Reminders page: 1/1 tasks completed, with a checked task
Reminders, with the number still open beside the list: add tasks, rename in place, tick to finish — done ones clear at midnight. A long title wraps as far as it needs.
Shelf: clipboard history of images, with their sizes
The files tray with six files, full
Shelf on your phone: scan the QR code to access the shelf files
Devices: galyarder connected via GSConnect, battery 50%, not charging, with Ring phone and Send clipboard
Shelf. Clipboard history of text, links, images and files — search, filter, pin; Super+V to paste. Files tray: drop up to 6 files on the island, drag them into any app or click to copy. Phone: scan the QR to save shelf files on your phone or send files back, in the browser, same Wi-Fi, nothing through the internet.
Weather page: Bogor conditions, hourly temperature chart, five-day forecast and a recent earthquake
Weather. Choose a city in Settings, or follow the GNOME World Clock nearest your time zone. See current conditions, humidity, wind, sunrise and sunset, an hourly curve colored by each forecast condition, and the five-day forecast. Nearby earthquakes use BMKG in Indonesia and USGS elsewhere; USGS fills in when BMKG has no nearby recent event. The closed island stays quiet.
Calendar: November 2026 beside today's events, R&D OAA and Design GBots
Calendar. The month beside the chosen day's events, from your desktop calendars (Google and others through Online Accounts). Add an event in one line: "Dinner 8:00 pm". A reminder 5 minutes before, with Join for Meet, Zoom, Teams or Webex. World clocks underneath.
Notifications: a Telegram notification, with Clear
Notifications. GNOME's notifications as a plain list, newest first, with their buttons under the pointer, Clear, and Do Not Disturb a click away.
Install vlc running in the closed island
Voice assistant. Press Super+I and ask, in English or Indonesian: play a song, find a file, add a reminder. It works as an agent: a request with several steps is done one after another, each step checked, with the AI you already use (Claude Code, Codex, Grok, Hermes, Oh My Pi, opencode or Antigravity).
The install command running: sudo pacman -S --needed vlc, asking to proceed
Installs and fixes things. "Install LibreOffice", "pasang codex": it checks what your Linux has, searches the web when unsure, and shows the one command it wants to run, with what to know first. Press Run or Deny. It runs in the background while you carry on, and the assistant checks it worked before saying so.
Chatting with the AI: asking where Notchfolk runs
Speak or type, and talk it through. It listens as soon as it opens; start typing to type instead. Scroll up for the conversation so far; select text to copy it, + for a new one. The bot turns to the pointer, blinks, and bounces as you speak; close the island and it carries on in the background.
The bot in eight shapes and several colours, with matching glows
A bot of your own. Eight shapes, from a circle to a cloud or a ghost, eleven colours or your own, softly shaded, and a glow round the island that matches it.
AI usage: Claude Max, 5 hours 42% (resets in 2h 18m), Week 18% (resets in 4d)
AI usage. How much of your Claude and ChatGPT plan limits is used: one plan at a time with its logo, a bar per limit and when each resets; scroll or click the dots to switch. A warning comes as one nears its end; only plans you're signed in to show.
Prayer alert: Dzuhur, it's time to pray in Bogor, 11:36
Alerts for volume, brightness, Caps Lock, charging, low battery, Bluetooth battery, going offline, reminders, meetings about to start, AI plan limits and GNOME notifications with their buttons — in the same place instead of the middle of the screen. Hold the pointer on one to keep it; × or swipe up to put it away.
Notchfolk wants to run sudo pacman -S --needed vlc, with Deny and Run
AI agents. When Claude Code or Codex asks permission to run something, answer from the island: Deny, Allow or, for Claude Code, Always. When one is done, the island says what it did. Nothing shows while you are in its window.
App usage: Firefox 1h 36m today, then ChatGPT, Muse and Files
App usage. Where your time goes: the app in front today, over the last seven days, or the last 30, with its icon, a bar and its time. Off until you turn it on; five idle minutes pause it, locking the screen stops it; kept on this computer for 30 days.
The conversation in the glass island, the desktop behind it showing through, blurred
Glass. The island in clear dark glass instead of black, if you prefer: what is behind it shows through, blurred, as you work. Choose it in Settings → Appearance → Island.
Router: 3,786 requests, 68M / 2.7M tokens, $37.11 estimated cost, connected
Router settings: Local or Remote connection, Base URL, proxy API key, period
Router. What your AI gateway reports: requests, tokens in and out, its cost estimate, the top models as bars, and the last ten requests. A health dot once connected; off by default.
Calories: today's intake 650 of 2,000 kcal, with a meal logged
Water: 0.8 of 2.0 L today, with the intake chart
Prayer: Dzuhur next at 11:36, with the day's prayer times
Everyday tools. Water and calories logged through the day, and prayer times for your city, all kept on this computer.
MCP settings: access scopes, remote access with a public hostname, and the tunnel setup
NotchFolks in the ChatGPT Apps directory
MCP server. An optional MCP server for agents outside Notchfolk: read tools for your data and actions, writes only what you list in ~/.config/notchfolk/mcp.env, on loopback by default and remote access through an authenticated tunnel. Beyond the island's own data, the world domains: System (the machine itself — stats, logs, files, processes, updates, the sharp tools behind their own scope), Browser (the web through a real browser: Camoufox, or your own Chromium over CDP) and Memory (the Hindsight engine's 39 tools — what the agent learns, kept across conversations). A domain whose backend is absent is not offered at all; a restricted tool is not even visible to a key without its scope.
The AI picker: Claude Code, Codex, Hermes Agent, OpenAI-compatible API, Oh My Pi, opencode, Antigravity
Oh My Pi selected, with Custom instructions for its identity
More AIs. The assistant also runs Hermes and Oh My Pi with the providers they are configured for, plus any OpenAI-compatible API.

Also: privacy dots while the camera, microphone or screen sharing is in use, a recording timer with a stop button, and a slim glass top bar that leaves your windows uncovered.

Requirements

  • GNOME Shell 46 to 51 (Ubuntu 24.04 to 26.10, Fedora 40 to 45, Debian 13, …), on a 64-bit Intel or AMD PC (x86_64). Check with gnome-shell --version.
  • curl, which most systems have (if not: sudo apt install curl). Install Notchfolk as yourself, not with sudo.
  • For the voice assistant (optional): a microphone and one of Claude Code, Codex, Grok, opencode or Antigravity signed in (Codex and the npm install of Claude Code need Node.js 18 or newer); see assistant guide. To have the answers spoken aloud, ffmpeg (sudo pacman -S ffmpeg, sudo apt install ffmpeg), which turns the router's audio into what pw-play plays.

Installation

  1. Run this in a terminal:

    curl -fsSL https://raw.githubusercontent.com/galyarderlabs/notchfolk/main/get.sh | bash
    
  2. Log out and back in: GNOME Shell on Wayland only loads a new extension at login (on GNOME 46 to 48 with X11, press Alt+F2, type r and press Enter instead).

That's all. The script downloads the latest release, checks it, and installs it for your user only: no root, no compiler and no cloning needed. Run the same command again to update; your settings stay as you set them.

The installation guide goes through it step by step, with updating, uninstalling, installing offline and what to do if the island does not appear.

[!NOTE] The installer never changes other extensions. When one would fight with the island (Blur my Shell's top bar blur, or an extension that takes the same place in the top bar), it says so and how to turn that off. Notchfolk's look is the same on every desktop: a slim top bar with no colour of its own, and the island as a black notch.

Documentation

  • Usage and settings — every gesture and shortcut, the Settings pages, troubleshooting and uninstalling
  • Assistant guide — the voice assistant, the AIs it runs (Claude Code, Codex, Grok, Hermes, Oh My Pi, opencode, Antigravity), agent approvals and AI plan usage
  • Installation guide — step by step, packages, AUR, offline install and other ways to install
  • MCP server — the optional MCP server and its permissions
  • Data and network — what is kept where and what leaves your computer; also SECURITY.md
  • How it works — the moving parts, D-Bus interfaces (dbus-api.md) and resource usage

Contributing

Bug reports, ideas and pull requests are welcome. See CONTRIBUTING.md for how to build, test and send changes, and CHANGELOG.md for what changed. Everyone taking part follows the Code of Conduct; please report security problems privately as described in SECURITY.md.

Author

  • @muhamadgalihsaputra — Galih: Notchfolk itself. Every change since the fork of Isle — the quiet island, the Weather page, the world MCP — and the direction behind them.

Contributors

Thanks to everyone who has made Notchfolk better:

  • @caffeinepx: Grok in the voice assistant and on the AI usage page; music from Zen and Firefox that keeps its place; a sun or a moon by each World Clock.
  • @Ashishranjan980: the Apps page, where your time in each app goes.
  • @daotheone: the DeepSeek request that became the assistant's shared endpoint rows — one Base URL and one API key, in Settings instead of a file.

Support

Notchfolk is free and always will be. If it makes your desktop nicer, you can sponsor Galyarder Labs on GitHub. A star, a bug report or telling a friend helps just as much.

License

Notchfolk is a modified version of Isle by zickrian, used under GPL-3.0-or-later. Copyright © 2026 zickrian for the upstream work; Copyright © 2026 Galyarder Labs for the modifications — both published under the same licence.

Notchfolk is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. It is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

The bundled Inter typeface (data/fonts) is under the SIL Open Font License 1.1. Lyrics come from LRCLIB. The Claude and OpenAI logos on the AI usage page come from Simple Icons (CC0); they are trademarks of Anthropic and OpenAI, shown only to name their plans. The assistant's face takes its expressions from bloub by Jérémy Perret, under the MIT License (notice). The calendar icon takes its shape from Lucide's "calendar-days", under the ISC License (notice).


Give Notchfolk a star

// faq

What is notchfolk?

A living desktop notch: music with synced lyrics, tasks, reminders, calendar, AI agents (Hermes, Claude Code, Codex, OMP), a built-in MCP server, AI router analytics, and subscription usage quota tracking. GNOME today — Windows and macOS coming.. It is open-source on GitHub.

Is notchfolk free to use?

notchfolk is open-source under the GPL-3.0 license, so it is free to use.

What category does notchfolk belong to?

notchfolk is listed under mcp-servers in the Claudeers registry of Claude-compatible tools.

8 views
★ 10 stars
unclaimed
updated 8 days ago

// embed badge

notchfolk on Claudeers
[![Claudeers](https://claudeers.com/api/badge/notchfolk.svg)](https://claudeers.com/notchfolk)

// retro hit counter

notchfolk hit counter
[![Hits](https://claudeers.com/api/counter/notchfolk.svg)](https://claudeers.com/notchfolk)

// reviews

// guestbook

0/500

// related in MCP Servers

🔓

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete…

// mcp-serversf/⟨HTML⟩★ 177,810◷ NOASSERTION[ claude ]
🔓

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

// mcp-serversfarion1231/⟨Rust⟩★ 155,814◷ MIT[ claude ]
🔓

🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman

// mcp-serversJuliusBrussee/⟨JavaScript⟩★ 117,780◷ MIT[ claude ]
🔓

An open-source AI agent that brings the power of Gemini directly into your terminal.

// mcp-serversgoogle-gemini/⟨TypeScript⟩★ 108,744◷ Apache-2.0[ claude ]
→ see how notchfolk connects across the ecosystem