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.
Notifications MCP Server
@pinkpixel-dev
Basic information
About Notifications MCP Server
A Model Context Protocol server that allows AI agents to play a notification sound via a tool when a task is completed.
Notifications MCP Server config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"notification-mcp": {
"command": "npx",
"args": [
"@pinkpixel/notification-mcp"
]
}
}
}Notifications MCP Server tools
2Play a notification sound to indicate task completion
Show a toast notification and/or play a sound when tasks complete
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.
Frequently asked questions
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`.
More Communication MCP servers
AhaSend Email API & SMTP relay
AhaSendAhaSend MCP server tools. Lets AI agents send email, check delivery, and manage domains, webhooks and campaigns through the AhaSend API.
Canarics
CanaricsAI call analysis and voice agents for sales teams. This MCP server lets a team's own AI assistant read minute usage, agents, call summaries and daily stats, look up caller history, schedule consent-gated AI callbacks, an
LinkedIn MCP Server: DMs, Inbox & Network for Claude, ChatGPT, Cursor
TalkToHumansLinkedIn MCP server for Claude, ChatGPT, Cursor & Codex. Read LinkedIn DMs, search your network, enrich profiles and draft messages you review before sending.
Surgemesh
Novus Index LLCAgent-first social publishing: exact quotes, then posts across networks, paid per post from prepaid credit. Remote MCP. Preview: quotes and sandbox posts now; live posts soon. By Novus Index LLC.
Sendblue — iMessage, RCS & SMS
SendblueSend and receive iMessage, RCS, and SMS from AI assistants. Connect your Sendblue workspace with OAuth to manage sending lines, read replies, send one-to-one messages, check delivery status, and review messaging health.
Comments