webhook-mcp
If you are the rightful owner of webhook-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A Model Context Protocol (MCP) server that sends webhook notifications when called.
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 payloadurl
: External URL to include in the webhook payload asexternalLink
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