Notifications MCP Server

@pinkpixel-dev

Basic information

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

Notifications MCP Server config

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

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

Notifications MCP Server tools

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.

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

More Communication MCP servers

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

MailTester Ninja

Unlimited & Limited

MailTester Ninja checks email addresses in real time by talking to the recipient's mail server, without sending a message, and keeps nothing afterwards. Agents can use it to clean a list, validate a signup, or find a con

HelpWell

Workado, LLC

HelpWell connects AI assistants to your help desk, knowledge base, live chat support and email marketing automation for SaaS. Triage support tickets, draft help docs and replies, manage contacts, and prepare newsletters

uplika

Hosted MCP server that lets your AI agent post to Threads, Instagram, YouTube, Facebook, TikTok, Pinterest, Bluesky, Telegram, Discord, Ghost and Naver Blog. Setup for each agent.

DemandBird

Write, schedule and publish social posts in your own voice, and read your analytics, from Claude, ChatGPT or any MCP client. Works with LinkedIn, X, Threads, Bluesky, Facebook, Instagram and more. Hosted, with OAuth sign