mcp -notify

This MCP server provides a lightweight desktop notification tool with full MCP protocol support. It integrates with editors and automation tools via MCP, enabling intelligent system notifications based on your rules and workflows. You can use it in two main ways: as an MCP server that other agents can query, and directly from the command line or programmatic API to trigger notifications. The CLI supports composing a title, message, and optional open targets like apps or URLs, while the programming interface exposes a sendNotification function to specify icon, sound, and an action to perform when the notification is clicked.

Prerequisites:

• Node.js and npm/yarn installed on your system
• Basic familiarity with MCP configuration files

Install globally (recommended for CLI access):

npm install -g @6starlong/mcp-server-notify

Alternative (using npx in MCP config as shown):

Configure the MCP server in your config:

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

Usage examples:

• Start using the MCP server with your editor/automation tool configured to connect to the notify server
• Run the CLI directly by invoking the generated binary (if installed globally) or via npx as shown above

Development notes:

• Build or test locally if you clone the repo, following its package.json scripts (e.g., pnpm install, pnpm run build, pnpm test)

Tips:

• The default notification icon is coding.png and the default sound is done.wav. You can override these with local file paths or URLs.
• Network resources may load with delay; the system will gracefully degrade to a fallback after the specified timeout (default around 3 seconds).
• You can mute frequent notifications using the provided mute options in your rules.
• Clicking a notification can activate an application, open a URL, or run a specified executable.
• See ~/rules/notify.md for customizing default styles, sounds, and project-specific notification behavior.