mcp-ding

MCP server for macOS native notifications with AI brand icons.

Send desktop notifications from any MCP-compatible AI agent with one-line tool calls — complete with 67 AI/Agent brand icons and system sound support.

Quick Start

npx -y mcp-ding

Or just tell your AI agent:

Install mcp-ding from https://github.com/zhuqingyv/mcp-notify and set it up as an MCP server.

The agent will clone the repo, install dependencies, register the MCP server, and configure permissions automatically.

Features

• send_notification — Send macOS native notifications via terminal-notifier, with title, subtitle, sound, and icon

• list_icons — List all 67 available AI brand icons

• list_sounds — List all macOS system sounds

• 67 AI brand icons — Covers major providers (Anthropic, OpenAI, Google, DeepSeek, Kimi, and more)

• Cross-Mac compatible — Dynamic terminal-notifier path detection for both Apple Silicon and Intel Macs

Screenshots / Preview

Coming soon

Prerequisites

• Node.js 18+

• terminal-notifier

brew install terminal-notifier

Installation

Via npx (recommended)

npx -y mcp-ding

Manual

git clone https://github.com/zhuqingyv/mcp-notify.git
cd mcp-notify
npm install

Setup

Universal MCP config (Cursor, Windsurf, Cline, and others)

Add to your MCP client's config file:

{
  "mcpServers": {
    "mcp-ding": {
      "command": "npx",
      "args": ["-y", "mcp-ding"]
    }
  }
}

Claude Code

claude mcp add mcp-ding -s user -- npx -y mcp-ding

Pre-authorize tools (Claude Code only — skip confirmation prompts)

Add to ~/.claude/settings.json under permissions.allow:

"mcp__mcp-ding__send_notification",
"mcp__mcp-ding__list_sounds",
"mcp__mcp-ding__list_icons"

Other MCP clients manage tool permissions through their own UI or config — this step is Claude Code-specific.

Usage

Send a notification

Send a notification: task complete

Send a notification with an icon

Send a notification with the openai icon: code review done

Equivalent tool call:

{
  "tool": "send_notification",
  "arguments": {
    "title": "Claude Code",
    "message": "Code review done",
    "icon": "openai",
    "sound": "Hero"
  }
}

List available icons

List all available notification icons

Calls list_icons — returns all icon names (without .png extension).

List available sounds

What notification sounds are available?

Calls list_sounds — returns system sound names usable in the sound parameter.

Available Icons

67 icons total. All are 128×128 PNG with brand color background and white label.

International Providers (37)

Chinese Providers (25)

AI Dev Tools & Platforms (5)

Adding Custom Icons

Place any 128×128 PNG in the icons/ directory. The filename (without .png) becomes the icon name usable in the icon parameter.

cp my-icon.png /path/to/mcp-notify/icons/my-icon.png
# then use: "icon": "my-icon"

To regenerate all built-in icons from scratch:

python3 gen_icons.py

Notification Hook Integration

Auto-notify when Claude finishes a task. Add to ~/.claude/settings.json:

{
  "hooks": {
    "Notification": [{
      "matcher": "",
      "hooks": [{
        "type": "command",
        "command": "bash -c 'MSG=$(cat); TITLE=$(echo \"$MSG\" | python3 -c \"import sys,json; d=json.load(sys.stdin); print(d.get(\\\"title\\\",\\\"Claude Code\\\"))\" 2>/dev/null || echo \"Claude Code\"); BODY=$(echo \"$MSG\" | python3 -c \"import sys,json; d=json.load(sys.stdin); print(d.get(\\\"message\\\",\\\"Done\\\"))\" 2>/dev/null || echo \"Done\"); terminal-notifier -title \"$TITLE\" -message \"$BODY\" -sound Hero -group claude-notify'"
      }]
    }]
  }
}

License

MIT