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

DashaMail

MCP server for DashaMail email marketing service

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

LinkedIn MCP Server: DMs, Inbox & Network for Claude, ChatGPT, Cursor

TalkToHumans

LinkedIn MCP server for Claude, ChatGPT, Cursor & Codex. Read LinkedIn DMs, search your network, enrich profiles and draft messages you review before sending.

JooVoice

Give your AI agent a phone. JooVoice makes real calls for you in 80+ languages, with local accents, across 67 countries, like booking a table, moving an appointment or chasing a refund, and sends back what happened. Call

Pidgeon

Email inboxes for AI agents. Give an agent its own address in one call; it sends, receives and replies in threads, waits for a sign-up code and gets it back already extracted, and hands a conversation to a person when it