send_notificationLABSCO SUMMARY
Notifications that reach you, with a platform table worth reading first.
The point is unattended work: the agent finishes and your screen tells you, instead of you checking a window every few minutes. Read the compatibility table before choosing a tool — on macOS a title, a message and a timeout is the whole vocabulary, and the icon and urgency calls have nothing to render.
What it is
A Rust server built on the notify-rust crate that sends native desktop notifications on Linux, macOS and Windows.
What you get
- send_notification for a title and a message
- send_urgent_notification for a high-priority one
- send_notification_with_icon for a custom icon
- send_notification_with_timeout to control how long it stays on screen
- send_rich_notification when you want every option in one call
- Prebuilt binaries per platform on the releases page
Requirements
A binary for your platform from the releases page, referenced by absolute path in the client config. What arrives depends on the OS: icons, urgency levels, categories and app names are Linux (XDG) features; macOS supports basic notifications and custom timeouts; Windows supports icons and urgency in limited form.
Setup effort
Follow the published steps
USE CASES
01
Being told when a long build or migration is done
One notification at the end of the run, so you can do something else while it goes.
02
Making a failure impossible to miss
Send the high-priority notification for errors and the plain one for progress.
03
Keeping a message on screen until you get back
Set the timeout explicitly rather than relying on the system default — this works on all three platforms.
04
Telling several agents' notifications apart at a glance
Give each one its own icon; on Linux you can also set the app name and category.
5 tools
Listed in project docs. Your client may show a different list.
send_urgent_notificationsend_notification_with_iconsend_notification_with_timeoutsend_rich_notificationBEFORE YOU INSTALL
What to know first
Tools you get
5 tools named in the project's documentation.
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
Download the binary for your platform from https://github.com/gbrigandi/mcp-server-desktop-notify/releases — mcp-server-desktop-notify-macos-arm64, -macos-amd64, -linux-amd64 or -windows-amd64.exe
Put the full path to the downloaded binary in the command field of your Claude Desktop configuration
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"desktop-notify": {
"command": "/Users/<YOUR_USERNAME>/Downloads/mcp-server-desktop-notify",
"args": []
}
}
}/Users/<YOUR_USERNAME>/Downloads/mcp-server-desktop-notify is the full path where you saved the downloaded binary.
