notifications-mcp-server

notifications-mcp-server

1

The Claude Notification Server is a lightweight MCP server designed to provide auditory and visual notifications for Claude Desktop on macOS. It supports native system sounds and customizable notifications, ensuring integration with macOS features. With minimal dependencies, it offers a flexible setup and multiple fallback notification methods.

Claude Notification Server

A lightweight MCP server that provides both auditory and visual notifications for Claude Desktop on macOS.

Features

  • Different sound notifications at the beginning and end of Claude responses
  • Compatible with macOS native system sounds
  • Easily customizable notification sounds
  • Visual desktop notifications through macOS Notification Center
  • Custom icons for visual notifications
  • Simple setup with minimal dependencies
  • Multiple notification methods with fallbacks

Installation and Setup

Prerequisites

  • macOS
  • Python 3.8 or higher
  • Claude Desktop application

How It Works

The server connects with Claude Desktop and offers task status notifications. Claude will call this tool at the start and end of each interaction, producing both audible and visual notifications.

Project Structure

  • Core functionality includes sound and visual notification management
  • Platform-specific implementations for macOS

Customizing Notifications

  • Change notification sounds through environment variables
  • Customize visual notifications with icons

Troubleshooting

  • Visual and sound notification troubleshooting steps

Uninstallation

  • Remove the repository and installed Python packages