✨ Notifications MCP Server ✨
@pinkpixel-dev
A Model Context Protocol server that allows AI agents to play a notification sound via a tool when a task is completed.
Overview
What is ✨ Notifications MCP Server ✨?
A Model Context Protocol server that allows AI agents to play notification sounds when tasks are completed. It is TypeScript-based and comes with bundled sounds that work out of the box with npx.
How to use ✨ Notifications MCP Server ✨?
Configure it in your MCP client with command: "npx" and args: ["-y", "@pinkpixel/notification-mcp"]. Optionally set environment variables MCP_NOTIFICATION_SOUND (chooses from 5 bundled sounds) or MCP_NOTIFICATION_SOUND_PATH (custom MP3 file). Then call the play_notification tool with an optional message parameter.
Key features of ✨ Notifications MCP Server ✨
- Plays notification sounds when tasks are completed.
- Cross-platform support (Windows and macOS).
- Offers 5 high-quality bundled sounds: cosmic, fairy, gentle, pleasant, retro.
- Supports random sound selection with
MCP_NOTIFICATION_SOUND=random. - Allows custom MP3 files via
MCP_NOTIFICATION_SOUND_PATH. - Works immediately via npx without manual downloads.
Use cases of ✨ Notifications MCP Server ✨
- Playing a sound after an AI agent finishes a long task.
- Providing audio feedback for completed operations in MCP-based workflows.
- Customizing notification tones for different types of task completions.
- Using a random sound each time for variety in notifications.
FAQ from ✨ Notifications MCP Server ✨
What sounds are included?
Five bundled sounds: cosmic (space-themed), fairy (magical), gentle (soft default), pleasant (professional), and retro (vintage). You can also set MCP_NOTIFICATION_SOUND=random to play one at random.
How do I use my own sound file?
Set the environment variable MCP_NOTIFICATION_SOUND_PATH to the absolute path of your MP3 file. This overrides the bundled sounds.
How do I install and run the server?
No installation is required; just run npx @pinkpixel/notification-mcp. You can also install globally with npm install -g @pinkpixel/notification-mcp and run notification-mcp.
What are the system requirements?
The server requires Node.js and works on Windows and macOS. Sound playback uses platform-native capabilities.
Can I change the default sound?
Yes. Set MCP_NOTIFICATION_SOUND to one of cosmic, fairy, gentle, pleasant, retro, or random. The default is gentle.
