Skillget

notifications-mcp-server

mcp
Security Audit
Pass
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 14 GitHub stars
Code Pass
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This is a macOS-focused Model Context Protocol (MCP) server that plays audio and visual alerts when an AI assistant completes a task. It exposes a tool for the model to trigger these notifications automatically.

Security Assessment
Overall Risk: Low. The tool does not access sensitive data, make external network requests, or contain hardcoded secrets. However, it does execute local shell commands (specifically `afplay`) to play audio. Because it is limited to triggering local macOS system sounds and visual alerts, the attack surface is minimal. A light code audit found no dangerous patterns, and the server does not request dangerous system permissions.

Quality Assessment
The project appears to be in active development, with recent repository pushes and dedicated test suites. It uses the permissive MIT license, making it safe for integration into almost any project. While it is relatively new with a small community (14 GitHub stars), the documentation is clear, accurate, and transparently details the tool's current limitations, such as being restricted exclusively to macOS.

Verdict
Safe to use.
SUMMARY

A Model Context Protocol (MCP) server that provides notifications for Claude Desktop on macOS. It plays configurable system sounds when Claude completes a task, enhancing user experience by eliminating the need for constant visual monitoring.

README.md

Notifications MCP Server

Tests

MCP server that lets Claude Desktop or another MCP client trigger macOS sound and visual notifications through a task_status tool.

Current Status

This is a macOS-focused utility. It is not an automatic Claude completion detector by itself: an MCP client or model must call the task_status tool when it wants a notification.

Recommended profile action: keep as a focused utility repo. Suggested topics: mcp, claude, claude-desktop, macos, notifications, python.

What Works Today

  • Registers a task_status MCP tool.
  • Plays macOS system sounds with afplay.
  • Sends visual notifications using terminal-notifier, AppleScript, PyObjC, or pync fallbacks.
  • Supports separate start and completion sounds.
  • Supports disabling visual notifications through an environment variable.
  • Includes tests for the modular notification and sound managers.

Important Limitations

  • macOS is the only implemented platform.
  • Linux and Windows support are not implemented.
  • Notifications only happen when the MCP tool is called.
  • The packaged console script is claude-notifications.
  • The Python package is notifications; there is no notifications_mcp_server module entry point.
  • Custom sound configuration uses environment variables, not the JSON configuration block that older README versions showed.

Installation

pip install notifications-mcp-server

Optional visual notification dependencies:

pip install "notifications-mcp-server[visual]"
pip install "notifications-mcp-server[pync]"

For terminal-notifier fallback support:

brew install terminal-notifier

Claude Desktop Configuration

Use the console script installed by the package:

{
  "mcpServers": {
    "notifications": {
      "command": "claude-notifications"
    }
  }
}

Restart Claude Desktop after changing the config.

Configuration

Environment variables:

export CLAUDE_START_SOUND="/System/Library/Sounds/Glass.aiff"
export CLAUDE_COMPLETE_SOUND="/System/Library/Sounds/Hero.aiff"
export CLAUDE_VISUAL_NOTIFICATIONS="true"
export CLAUDE_NOTIFICATION_ICON="/path/to/icon.png"

If no custom sounds are set, the server uses macOS system sounds.

MCP Tool

task_status

Input:

{
  "message": "Task completed"
}

Messages containing start or processing are treated as start notifications. Other messages are treated as completion notifications.

Development

git clone https://github.com/charles-adedotun/notifications-mcp-server.git
cd notifications-mcp-server
pip install -e ".[dev]"
pytest

License

MIT

Reviews (0)

No results found