send_notificationLABSCO SUMMARY
One tool that solves the “is it done yet?” problem.
Tell the agent to notify you when the task ends and long runs stop needing a babysitter; in Cursor you can put that instruction in Rules once rather than typing it every time. The install is the fiddly part, because the notification backend needs a platform helper installed separately — pywin32 on Windows, terminal-notifier on macOS.
What it is
A Python server whose whole job is to fire a system desktop notification, with an alert sound, when an agent task completes. Delivery goes through Apprise, so Windows, macOS and Linux are all covered.
What you get
- A desktop notification the moment a task finishes
- An alert sound bundled with the package, so you notice it from another window
- One tool,
send_notification, that any MCP client can call at the end of a run - Debug output and a log file option, for working out why a notification never appeared
Requirements
Install mcp-server-notify from PyPI with uv or pip. Windows also needs pywin32; macOS needs terminal-notifier from Homebrew. Docker is not a working path here — a container cannot reach the host's notification system.
Setup effort
Follow the published steps — git clone https://github.com/Cactusinhand/mcp_server_notify.git
USE CASES
01
Walking away from a long build
End the prompt with an instruction to notify you, then go do something else — the sound reaches you from another room.
02
Making the reminder automatic
Put the notify instruction into your editor's rules file once, so every task ends with a ping without you asking.
03
Working out why nothing popped up
Start the module in debug mode with a log file and read what the notification backend reported.
1 tool
Listed in project docs. Your client may show a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool named in the project's documentation.
Requires
uv on PATH
Where it runs
All 4 documented setups run the server on your machine.
INSTALLATION
Connect your client
Server setup
From source
TERMINAL
git clone https://github.com/Cactusinhand/mcp_server_notify.git
cd mcp_server_notify
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
uv pip install mcp-server-notify
# or
pip install mcp-server-notifypip
TERMINAL
pip install mcp-server-notifyMCP Clients
Claude Desktop — uv, Cursor — uv
JSON
{
"mcpServers": {
"NotificationServer": {
"command": "uv",
"args": [
"--directory",
"<YOUR_PATH_TO_MCP_SERVER_NOTIFY> project",
"run",
"mcp-server-notify"
]
}
}
}Claude Desktop — Python
CLAUDE DESKTOP — PYTHON · JSON
{
"mcpServers": {
"NotificationServer": {
"command": "python",
"args": [
"-m",
"mcp_server_notify"
]
}
}
}VS Code
VS CODE · JSON
{
"servers": {
"notifier": {
"command": "uvx",
"args": [
"mcp-server-notify"
],
"env": {}
}
}
}
