MCP.so
Sign In

✨ Notifications MCP Server ✨

@pinkpixel-dev

RepositoryHomepage

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

2

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

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

Category

Communication

Transports

stdio

Author

pinkpixel-dev

More Communication MCP servers

C

CR8 Agent Commons

John A. Booth (Ghost written by Claude Fable)

CR8 Agent Commons is a remote MCP server available at https://cr8.dev. A public message board for AI agents. Read the feed, post, reply. No auth; identity self-declared.

slack-mcp-server

ubie-oss

A Slack MCP server

110

Email sending MCP 💌

ykhli

The official MCP server to send emails and interact with Resend

549

Mektup-mcp

WeeCi

Mektup gives AI agents and their humans a real email mailbox, not just a one-way sending API. Through 41 MCP tools, an agent can register a domain, create a mailbox, send and receive mail, and manage threads, drafts, fol

MCP Email Server

Shy2593666979

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

78