MCP.so
Sign In

MCP Server Notifier

@tuberrabbit

Repository

About MCP Server Notifier

Lightweight Node.js server sending webhook notifications. Ideal for devs using AI agents (e.g., Cursor) on multi-projects, alerting task completion for efficient switching. Features webhook alerts, multi-project dev, AI integration, easy setup for dev tools & automation.

Config

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

{
  "mcpServers": {
    "mcp-server-notifier": {
      "command": "docker",
      "args": [
        "pull",
        "zudsniper/mcp-server-notifier:latest"
      ]
    }
  }
}

Tools

1

Send rich notifications to any configured webhook

Overview

What is MCP Server Notifier?

A lightweight notification service that integrates with MCP (Model Context Protocol) to send webhooks when AI agents complete tasks. It supports multiple webhook providers and customizable messages.

How to use MCP Server Notifier?

Install globally via npm (npm install -g mcp-server-notifier), Docker (docker pull zudsniper/mcp-server-notifier), or from source. Configure with environment variables WEBHOOK_URL and WEBHOOK_TYPE, then invoke via MCP client or Cursor integration. The server exposes a notify tool for sending rich notifications.

Key features of MCP Server Notifier

  • Send webhook notifications when AI agents finish tasks.
  • Supports Discord, Slack, Microsoft Teams, Feishu, Ntfy, and generic JSON.
  • Include images in notifications via Imgur integration.
  • Multi-project management with separate webhook configurations.
  • Customizable messages with title, body, link, and attachments.
  • Template support for ntfy (status, question, progress, problem).

Use cases of MCP Server Notifier

  • Alerting a team when a long-running data processing task completes.
  • Sending progress updates for automated build or backup jobs.
  • Reporting errors or critical issues from an AI agent to a chat channel.
  • Notifying a user about a question that requires human input.
  • Tracking status of multiple projects through a single notification server.

FAQ from MCP Server Notifier

Which webhook types are supported?

Discord, Slack, Microsoft Teams, Feishu, Ntfy, and Generic JSON (via WEBHOOK_TYPE).

How do I use authentication tokens?

Set WEBHOOK_TOKEN for ntfy webhooks only; it is sent as a Bearer token in the Authorization header. Basic authentication is not supported, and the token is ignored by other providers.

Can I include images in notifications?

Yes. Use the optional image parameter with a local file path to upload to Imgur, or provide an imageUrl for an external image. Imgur upload requires a clientId in the configuration.

What parameters does the notify tool accept?

message (required), plus optional title, link, imageUrl, image, priority (ntfy only, 1-5), attachments (ntfy only), template, templateData, and actions (ntfy only).

Are templates fully supported?

Templates (status, question, progress, problem) are currently under development with limited support. They work best with ntfy.sh but may not be fully implemented for all webhook providers.

Frequently asked questions

Which webhook types are supported?

Discord, Slack, Microsoft Teams, Feishu, Ntfy, and Generic JSON (via `WEBHOOK_TYPE`).

How do I use authentication tokens?

Set `WEBHOOK_TOKEN` for ntfy webhooks only; it is sent as a Bearer token in the `Authorization` header. Basic authentication is not supported, and the token is ignored by other providers.

Can I include images in notifications?

Yes. Use the optional `image` parameter with a local file path to upload to Imgur, or provide an `imageUrl` for an external image. Imgur upload requires a `clientId` in the configuration.

What parameters does the `notify` tool accept?

`message` (required), plus optional `title`, `link`, `imageUrl`, `image`, `priority` (ntfy only, 1-5), `attachments` (ntfy only), `template`, `templateData`, and `actions` (ntfy only).

Are templates fully supported?

Templates (status, question, progress, problem) are currently under development with limited support. They work best with ntfy.sh but may not be fully implemented for all webhook providers.

Comments

Basic information

Category

Developer Tools

License

MIT

Transports

stdio

Author

tuberrabbit

More Developer Tools MCP servers

Hello World MCP Server (Reference Extension)

anthropics

Desktop Extensions: One-click local MCP server installation in desktop apps

2.0K

Deepwiki MCP Server

regenrek

📖 MCP server for fetch deepwiki.com and get latest knowledge in Cursor and other Code Editors

1.4K

Reelier

Maxime Houle

Agents make claims. Reelier writes receipts — record an agent's tool-call workflow once, replay it deterministically at 0 tokens, and diff runs to catch drift.

OpenSumi

opensumi

A framework helps you quickly build AI Native IDE products. MCP Client, supports Model Context Protocol (MCP) tools via MCP server.

3.6K

TaskerArmy Agent

TaskerArmy

Ask Claude or ChatGPT what Shopify theme optimization tasks are pending on your store, a remote MCP server for TaskerArmy Agent accounts.