📢 MCP Notify Server

Send system notification when Agent task is done

Catalog onlyCatalog onlySTDIO

Overview

MCP Notify Server is a service that provides system notification functionality for Large Language Models (LLMs) using the Model Context Protocol (MCP). It sends desktop notifications when an agent task is completed.

To use MCP Notify Server, install it via the uv package manager, configure it in your LLM client, and add a prompt to trigger notifications upon task completion.

Sends desktop notifications upon agent task completion. - Plays alert sounds to grab user attention. - Cross-platform support (Windows, macOS, Linux). - Integrates with various LLM clients based on the standard MCP protocol.

Notifying users when an AI task is completed.
Alerting users with sound notifications for important tasks.
Integrating with LLM clients for enhanced user experience.

Add to your AI client

Use these steps to connect 📢 MCP Notify 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": {
    "mcp-server-notify-cactusinhand": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-notify-cactusinhand"
      ]
    }
  }
}

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": {
    "mcp-server-notify-cactusinhand": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-notify-cactusinhand"
      ]
    }
  }
}

Claude Code

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

.mcp.json (project root)

{
  "mcpServers": {
    "mcp-server-notify-cactusinhand": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-notify-cactusinhand"
      ]
    }
  }
}

VS Code (Copilot)

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

.vscode/mcp.json

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

Windsurf

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server-notify-cactusinhand": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-notify-cactusinhand"
      ]
    }
  }
}

Cline

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

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "mcp-server-notify-cactusinhand": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-notify-cactusinhand"
      ]
    }
  }
}

FAQ

Can MCP Notify Server run on all operating systems?

Yes! It supports Windows, macOS, and Linux.

How do I install MCP Notify Server?

You can install it using the uv package manager or pip.

Is there a way to run it in Docker?

Currently, running it in Docker is complex due to OS-specific notification systems.

Developer tools