mcpField
W
Webhook MCP Server

Webhook MCP Server

Local
github.com/noobnoocCommunication3Updated 78w ago
Repository

About Webhook MCP Server

Webhook MCP Server sends notifications to a configured webhook URL when called. It is intended for AI assistant workflows that need to report completion of long-running tasks, with optional message and external link fields.

Key features

  1. 01Send notifications to a configured webhook
  2. 02Include a custom message
  3. 03Attach an external link
  4. 04Configure with a webhook URL

Use cases

  1. 01Notify when a long-running task finishes
  2. 02Include a task-specific message in an alert
  3. 03Link a notification to an external page

MCP support

Exposes a webhook notification tool to MCP clients. The server sends the configured URL a notification with optional message and external link parameters.

#mcp#webhook#notification#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "webhook": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
Run commandnpx -y @smithery/cli

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@smithery/cli

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Webhook MCP Server

Install in VS Code Install in VS Code Insiders Install in VS Code Install in VS Code Insiders smithery badge

A Model Context Protocol (MCP) server that sends webhook notifications when called.

You can use this server with webhook notification services like Echobell to get notified when long-running tasks are completed. Simply configure the server with your Echobell webhook URL (or another service's URL) and instruct your AI assistant to "send me a notification when it's done" within your task prompts.

Configuration

There are several ways to configure the MCP server:

Installing via Smithery

To install Webhook MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @noobnooc/webhook-mcp --client claude
Claude & Cursor & Windsurf

Configure Claude, Cursor or Windsurf to use the MCP server by adding this to your configuration:

  • With NPM:
{
  "mcpServers": {
    "notification": {
      "command": "npx",
      "args": ["-y", "webhook-mcp"],
      "env": {
        "WEBHOOK_URL": "your-webhook-url-here"
      }
    }
  }
}
  • With Docker:
{
  "mcpServers": {
    "notification": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "WEBHOOK_URL",
        "noobnooc/webhook-mcp"
      ],
      "env": {
        "WEBHOOK_URL": "<your-webhook-url-here>"
      }
    }
  }
}
VS Code

Add the following configuration to your VS Code settings.json:

  • With NPM:
{
  "mcp": {
    "servers": {
      "notification": {
        "command": "npx",
        "args": ["-y", "webhook-mcp"],
        "env": {
          "WEBHOOK_URL": "your-webhook-url-here"
        }
      }
    }
  }
}
  • With Docker:
{
  "mcp": {
    "servers": {
      "notification": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "WEBHOOK_URL",
          "noobnooc/webhook-mcp"
        ],
        "env": {
          "WEBHOOK_URL": "<your-webhook-url-here>"
        }
      }
    }
  }
}

Environment Variables

  • WEBHOOK_URL (required): The URL where webhook notifications will be sent

Parameters

The webhook can be called with optional parameters:

  • message: Custom message to include in the webhook payload
  • url: External URL to include in the webhook payload as externalLink

Development

To build the project:

npm install
npm run build

To run with the MCP inspector for debugging:

npm run inspector

Publishing

To build and publish the package:

npm run publish

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.