Notifications MCP Server

@pinkpixel-dev

代码仓库主页

基本信息

分类

沟通协作

传输方式

stdio

作者

pinkpixel-dev

关于 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 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

Notifications MCP Server 工具

Play a notification sound to indicate task completion

Show a toast notification and/or play a sound when tasks complete

概览

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.

常见问题

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

沟通协作分类下的更多 MCP 服务器

Postdom

Postdom is an AI social media tool that turns your website into short videos, slideshows and posts, then publishes them.

SocialFaktory

Run a brand's social media from your agent: write posts in the brand's voice, generate short videos, schedule and publish to TikTok, Instagram, YouTube, X, LinkedIn, Facebook and Pinterest, and read the metrics back. 21

Mobile Text Alerts SMS

Mobile Text Alerts

Official Mobile Text Alerts server. Send and schedule SMS, manage subscribers and groups, and complete carrier registration from any MCP-compatible AI assistant.

Artil — Email, SMS & Messaging for AI Agents

Artil

Artil — Email, SMS & Messaging for AI Agents is a remote MCP server available at https://mcp.artil.ai.

SocialRobot

socialrobot-io

Schedule and analyze social media posts from Claude, ChatGPT, Cursor, or Gemini. SocialRobot's remote MCP server connects Instagram, LinkedIn, X, TikTok, Facebook, Threads, Pinterest, Bluesky, and Mastodon, then creates,