Notify Mcp

Name: Notify Mcp
Author: longdog

@longdog

About Notify Mcp

A lightweight Bash-based Model Context Protocol (MCP) server for sending desktop notifications via notify-send. This zero-dependency server enables AI assistants like Claude, Cursor, and VS Code to send system notifications directly to your Linux desktop.

#linux #gnome #notify

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Notify Mcp?

Notify Mcp is a lightweight Bash-based Model Context Protocol (MCP) server that sends desktop notifications via notify-send. It enables AI assistants like Claude, Cursor, and VS Code to deliver system notifications to Linux desktops and macOS.

How to use Notify Mcp?

Clone the repository, make the script executable, and optionally add it to your PATH. Configure the server in your AI assistant’s MCP settings (Claude Desktop, Cursor, VS Code, or Gemini CLI) by specifying the absolute path to notify-mcp.sh as a command‑type stdio server. For testing, you can pipe JSON‑RPC requests directly to the script.

Key features of Notify Mcp

Zero‑dependency Bash MCP server (requires only notify-send and jq)
Sends Linux desktop and macOS notifications from AI assistants
Works with Claude Desktop, Cursor, VS Code, and Gemini CLI
Simple stdio‑based transport for direct interaction
Lightweight, single‑script implementation

Use cases of Notify Mcp

AI assistant notifies you when a long‑running task completes
Receive desktop alerts for code reviews or build failures from an IDE
Get a system toast when a CLI‑based AI session finishes a command
Trigger custom notifications from any MCP‑compatible agent

FAQ from Notify Mcp

What does Notify Mcp do?

It is an MCP server that calls the system’s notify-send command to display desktop notifications, allowing AI tools to pop up messages on Linux and macOS.

What prerequisites does Notify Mcp require?

A Linux system with libnotify (providing notify-send) or macOS, plus the jq command for JSON processing.

How do I install notify-send on Linux?

On Ubuntu/Debian: sudo apt-get install libnotify-bin. Fedora/RHEL: sudo dnf install libnotify. Arch: sudo pacman -S libnotify. Alt Linux: sudo apt-get install notify-send.