drio
Open app

Claude Notification Server

Source

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.

Catalog onlyCatalog onlySTDIO

Overview

Claude Notification Server is a lightweight Model Context Protocol (MCP) server designed to provide auditory and visual notifications for the Claude Desktop application on macOS. It enhances user experience by notifying users when Claude starts and completes tasks, eliminating the need for constant visual monitoring.

To use the server, clone the repository, install the necessary dependencies, and register it with Claude Desktop. After installation, it will automatically connect to Claude and provide notifications during task processing.

  • 🔔 Different sound notifications for task start and completion - 💻 Compatible with macOS native system sounds - 🎵 Customizable notification sounds via environment variables - 🔔 Visual notifications through macOS Notification Center - 🚀 Simple setup with minimal dependencies
  1. Notifying users when Claude begins processing a request.
  2. Alerting users when Claude completes a task.
  3. Customizing notification sounds for a personalized experience.

Add to your AI client

Use these steps to connect Claude Notification Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "notifications-mcp-server-charles-adedotun": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-notifications-mcp-server-charles-adedotun"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "notifications-mcp-server-charles-adedotun": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-notifications-mcp-server-charles-adedotun"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "notifications-mcp-server-charles-adedotun": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-notifications-mcp-server-charles-adedotun"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "notifications-mcp-server-charles-adedotun": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-notifications-mcp-server-charles-adedotun"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "notifications-mcp-server-charles-adedotun": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-notifications-mcp-server-charles-adedotun"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "notifications-mcp-server-charles-adedotun": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-notifications-mcp-server-charles-adedotun"
      ]
    }
  }
}

FAQ

Can I customize the notification sounds?

Yes! You can set custom sounds using environment variables.

Is it compatible with all versions of macOS?

The server is designed to work on macOS with Python 3.8+.

How do I troubleshoot if notifications are not working?

Check your notification permissions in System Preferences and ensure the server is running correctly.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":3016,"uuid":"1962f4a4-4c70-4b25-9e47-caae0915d8eb","name":"notifications-mcp-server","title":"Claude Notification Server","description":"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.","avatar_url":"https://avatars.githubusercontent.com/u/70953257?v=4","created_at":"$D2025-03-17T01:55:35.012Z","updated_at":"$D2025-03-17T02:33:35.661Z","status":"created","author_name":"charles-adedotun","author_avatar_url":"https://avatars.githubusercontent.com/u/70953257?v=4","tags":"macos,mcp,claude,notification-system,llm-tools","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/charles-adedotun/notifications-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"0\",\"license\":\"MIT license\",\"language\":\"Python\",\"is_official\":false,\"latest_commit_time\":\"2025-03-19 21:17:36\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools