notification-mcp

Notification MCP Server

notification-mcp lets AI agents signal finished tasks with notification sounds for people using MCP clients. Its tools include play_notification and notify, covering audio alerts and toast notifications.

Server facts

notification-mcp

Project

License
Not specified

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.

Related MCP servers