banner_notification
Display a banner notification on macOS.
LABSCO SUMMARY
The agent tells you it finished instead of you going back to check.
Three routes for three situations: a sound when you are at the desk, a banner when you are in another window, speech when you are not looking at the screen at all. list_available_voices exists because the voice argument only accepts what is actually installed on the machine, and test_notification_system covers the usual failure — a permission that quietly swallows banners so nothing arrives and nothing errors. All of it is local; nothing reaches a phone.
What it is
A macOS notification server with three delivery routes — sound, banner and speech — plus a voice list and a self-test.
What you get
- sound_notification, playing a named macOS system sound
- banner_notification, with a title, subtitle, message and an optional sound
- speak_notification, speaking text through macOS text-to-speech with a chosen voice, rate and volume
- list_available_voices, returning the text-to-speech voices installed on this machine
- test_notification_system, which tries every method and returns a diagnostic report
Requirements
macOS. The tools use its notification banners and its installed text-to-speech voices.
Setup effort
One command — uvx macos-notification-mcp
USE CASES
01
Knowing a long job finished without watching it
A sound is enough when you are at the keyboard; a banner carries the detail — which job, which result — in its title and subtitle for when you come back to the machine.
02
Getting a message that reaches you across the room
Text-to-speech is the route that does not need you to be looking at the screen. Voice, rate and volume are set on the call, so check the installed voices before naming one.
03
Confirming the alerts will actually arrive
Before an agent starts depending on one route, run the diagnostic that tries them all and read back which ones the machine actually delivered.
5 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
list_available_voices
List all available text-to-speech voices on the system.
Returns: A string listing all available voices
sound_notification
Play a system sound notification.
speak_notification
Use macOS text-to-speech to speak a message.
test_notification_system
Test the notification system by trying all notification methods.
Returns: A diagnostic report of the notification system
BEFORE YOU INSTALL
What to know first
Tools you get
5 tools when we connected.
Requires
uvx on PATH
CONTEXT COST
Light Standing cost
Rated by the size of the 5 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"macos-notification-mcp": {
"command": "uvx",
"args": [
"macos-notification-mcp"
]
}
}
}uvx
TERMINAL
uvx macos-notification-mcp
