Notify

A lightweight Bash-based MCP server that sends desktop notifications via notify-send.

other

1

GitHub Stars

other

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "longdog-notify-mcp": {
      "command": "./notify-mcp.sh",
      "args": []
    }
  }
}

Notify MCP Server is a lightweight Bash-based MCP server that forwards requests to your Linux desktop as system notifications via notify-send. It enables AI assistants and editors to trigger on-screen alerts directly on your desktop, making it easy to stay informed without leaving your environment.

How to use

You run the MCP server locally and connect your editor or tool to it using a stdio transport. The server accepts JSON-RPC like messages via standard input and shows desktop notifications using notify-send. To test or use it, pipe a properly formatted request into the server script and you will see a notification pop up on your desktop.

How to install

Prerequisites for smooth operation are a Linux system with notification support, the notify-send command (usually provided by the libnotify package), and the jq tool for parsing if you extend usage locally.

Additional configuration details

Install the MCP server script and make it executable. You can optionally add it to your PATH for convenient access.

Example usage and testing

# Step 1: Clone the project
git clone https://github.com/longdog/notify-mcp.git
cd notify-mcp

# Step 2: Make the script executable
chmod +x notify-mcp.sh

# Step 3: (Optional) Add to PATH for easier access
sudo ln -s $(pwd)/notify-mcp.sh /usr/local/bin/notify-mcp

# Step 4: Test via stdio transport
echo '{"jsonrpc":"2.0","id":"2","method":"show","title":"Hello","message":"World"}' | ./notify-mcp.sh

What you can configure

The server is designed to be simple to wire up with MCP clients. Use the stdio transport to send a notification request, and the server will render it as a desktop alert.

Available tools

notify

Sends a desktop notification using the system's notify-send command by receiving requests through an MCP channel.