show_completion_notificationLABSCO SUMMARY
You get your attention back during the long runs.
The notification is native to the operating system and carries the project name, which is what makes it useful when three editors are working at once and you are reading something else entirely.
What it is
A notifier for AI code editors. When a response completes, it raises a native system notification — the macOS notification centre, the Windows notification system, or libnotify on Linux — with the project name as the title.
What you get
- Native notifications on macOS, Windows and Linux, each with icon and sound support
- The current project name shown as the title, so several editor windows stay distinguishable
- Custom message text, custom icon, and sound that can be turned off
- Two ways to fire: automatically when a response finishes, or called deliberately at a point you choose
Requirements
Node.js with npm, and libnotify on Linux. It is built from source and the config points at the built file. One extra step actually makes it fire on its own: add a user rule telling the assistant to call it only as the final step after the answer is complete, and enable auto-run in the editor.
Setup effort
Build from source — git clone https://github.com/zhiyingzzhou/ai-notify-mcp.git
USE CASES
01
Walking away from a long refactor
Start the work, switch to something else, and be told when the answer is actually complete instead of checking back every two minutes.
02
Running several projects at once
The project name is the notification title, so when two windows are both working you know which one just finished without switching to either.
03
Keeping the desk quiet
Turn the sound off and keep the visual notification, or set a custom icon and message, so the alert fits the environment you work in.
04
Firing an alert at a point you choose
Trigger the notification deliberately rather than on completion — useful when the milestone you care about is partway through a longer sequence.
2 tools
Listed in project docs. Your client may show a different list.
auto_notify_completionBEFORE YOU INSTALL
What to know first
Tools you get
2 tools named in the project's documentation.
Requires
- Node.js 14+ and npm
- libnotify on Linux
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
TERMINAL
git clone https://github.com/zhiyingzzhou/ai-notify-mcp.git
cd ai-notify-mcp
npm install
npm run buildMCP Clients
Cursor
CURSOR · JSON
{
"mcpServers": {
"ai-notify": {
"command": "node",
"args": [
"<YOUR_PATH_TO_AI_NOTIFY_MCP>/dist/index.js"
],
"autoRun": true
}
}
}
