Server facts
notification-mcp
Project
- Author
- pinkpixel-dev
- Website
- pinkpixel.dev
- License
- Not specified
- Category
- Communication
Tech
- Runtime / language
- node
- Transports
- stdio
- Remote available
- No
- Authentication
- Not specified
Activity
- GitHub stars
- 14
- Last commit
- Data as of
Tags
- Nodejs
- Typescript
- agent
- ai
- llm
- mcp
- mcp server
- mcp tools
- model context protocol
- model context protocol servers
- notifications
- sound
Overview
Task-completion alerts are the focus of notification-mcp, a TypeScript project running on Node with stdio transport. An MCP client can invoke play_notification when an agent finishes work, with an optional message to accompany the alert. The supplied tool inventory also lists notify for toast notifications, sound playback, or both. Audio playback is documented for Windows and macOS. The package includes its sound files, so users can choose a bundled tone without downloading audio separately.
Sound selection centers on environment configuration. MCP_NOTIFICATION_SOUND selects cosmic, fairy, gentle, pleasant, or retro; choosing random varies playback among the included sounds. Gentle is the fallback when no selection is provided. For a personal audio file, MCP_NOTIFICATION_SOUND_PATH accepts an absolute MP3 path and takes precedence over the bundled selection. The documented setup options cover npx, global installation, and local installation. Developers can also build the project locally, use automatic rebuilding during development, and test the server interactively through MCP Inspector.
notification-mcp setup notes
- notification-mcp records stdio only; confirm a network transport upstream before planning remote access.
- notification-mcp has no recorded license; confirm reuse terms in its repository.