webhook-mcp

Webhook MCP Server

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