✨ Notifications MCP Server ✨

Name: ✨ Notifications MCP Server ✨
Author: pinkpixel-dev

@pinkpixel-dev

Repository Homepage

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 #nodejs #agent #typescript #ai #mcp #sound #llm #model-context-protocol #mcp-server #mcp-tools #model-context-protocol-servers

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "notification-mcp": {
      "command": "npx",
      "args": [
        "@pinkpixel/notification-mcp"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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.