Ai Notify

A cross-platform MCP server that notifies you when AI responses complete, with customizable title, message, icon, and sound.

typescript

1

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 months 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": {
    "zhiyingzzhou-ai-notify-mcp": {
      "command": "node",
      "args": [
        "/绝对路径/ai-notify-mcp/dist/index.js"
      ]
    }
  }
}

Ai Notify MCP is an intelligent notification server designed to work with the MCP protocol. It automatically sends system notifications when an AI assistant completes its response, enhancing your coding workflow across platforms.

How to use

You will run a local MCP client that talks to the Ai Notify MCP server. When the AI finishes generating a response, the server triggers a native system notification on your machine. You can tailor the notification content, icon, and sound, and you can also invoke notifications programmatically from your workflow.

Key usage patterns include enabling auto-run so that notifications trigger automatically after a complete answer, or manually triggering a notification through the provided tool when you want to notify at a specific moment. Adjust the defaults to match your project name, preferred message, and notification sound settings.

How to install

Prerequisites you need before installation are Node.js version 14.0.0 or newer and npm version 6.0.0 or newer. If you are on Linux, you also need libnotify installed to enable desktop notifications.

Install steps you will follow in order are:

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

# 2. Install dependencies and build
npm install
npm run build

If you are on Linux, ensure libnotify is installed for your distribution:

# Ubuntu/Debian
sudo apt-get install libnotify-bin

# CentOS/RHEL/Fedora
sudo dnf install libnotify

# Arch Linux
sudo pacman -S libnotify

# openSUSE
sudo zypper install libnotify-tools

Next, configure the MCP client to use the local server by adding the following configuration snippet to your MCP setup. This points to the local runtime entry that starts the server from the built distribution.

{
  "mcpServers": {
    "ai-notify": {
      "command": "node",
      "args": ["/绝对路径/ai-notify-mcp/dist/index.js"],
      "autoRun": true
    }
  }
}

Additional setup and notes

Create an editor rule to ensure notifications follow the intended lifecycle. The rule should trigger the notification only after you have fully completed your AI response, not during intermediate thinking or tool use.

To enable automatic running of the notification service, follow these steps in your editor’s settings:

Cursor Settings -> Features -> Chat
Enable auto-run mode
Restart Cursor

Troubleshooting

If notifications do not appear, verify that the auto-run mode is enabled, the MCP configuration path is correct, the service is started, and your system notification permissions are granted. Check that the AI assistant rules are properly configured so the notification triggers after a complete answer.

Notes on configuration and usage

You can customize how notifications look and sound by adjusting the notification configuration. Set the title, message, and icon, and decide whether to play a sound. You can also decide whether to use a default title and message or override them per notification.

Available tools

show_completion_notification

Manually trigger a notification with customizable title, message, and sound options.

auto_notify_completion

Automatically trigger a notification after the AI finishes generating a response, with optional response length metadata.