GitHub - noobnooc/webhook-mcp: A Model Context Protocol (MCP) server that sends webhook notifications when called. (original) (raw)

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": "" } } } }

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": "" } } } } }

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:

Publishing

To build and publish the package: