✨ Notifications MCP Server ✨

@pinkpixel-dev

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

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.

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.

Frequently asked questions

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`.

Comments

Basic information

More Communication MCP servers

MCP Email Server

Shy2593666979

一个基于 MCP (Model Context Protocol) 的邮件服务，支持 LLM 发送带附件的电子邮件及在指定目录中搜索文件。提供安全的 SMTP 传输、多收件人支持和附件模式匹配搜索功能，适用于 Gmail、Outlook、Yahoo、QQ 邮箱和网易 126 邮箱等主流邮箱服务。

Twilio MCP Monorepo

twilio-labs

Monorepo providing 1) OpenAPI to MCP Tool generator 2) Exposing all of Twilio's API as MCP Tools

108

Mcp Telegram

dryeab

MCP Server for Telegram

244

Email sending MCP 💌

resend

The official MCP server to send emails and interact with Resend

549

MCP Teams Server

InditexTech

An MCP (Model Context Protocol) server implementation for Microsoft Teams integration, providing capabilities to read messages, create messages, reply to messages, mention members.

383