Webhook MCP Server

What is Webhook MCP Server?

A Model Context Protocol (MCP) server that sends a webhook notification when it is invoked. It works with any webhook‑based notification service (e.g., Echobell) and is intended for notifying users when long‑running AI tasks complete.

How to use Webhook MCP Server?

Configure the server in your MCP client (Claude, Cursor, Windsurf, or VS Code) by setting the WEBHOOK_URL environment variable to your webhook endpoint. The server is run either via npx -y webhook-mcp or using the Docker image noobnooc/webhook-mcp. Instruct your AI assistant to “send me a notification when it’s done” to trigger the webhook.

Key features of Webhook MCP Server

• Sends HTTP webhook notifications when called by an AI assistant.
• Supports custom message and external URL in the payload.
• Works with any HTTP‑based webhook service.
• Run via npm or Docker with zero configuration beyond the webhook URL.
• Compatible with Claude, Cursor, Windsurf, and VS Code.

Use cases of Webhook MCP Server

• Get notified when a long‑running AI task completes.
• Integrate with Echobell or other webhook notification services.
• Receive a custom message and a link to external results when a job finishes.

FAQ from Webhook MCP Server

What is the WEBHOOK_URL environment variable?

It is the required URL where the webhook notification will be sent. You must set it before starting the server.

How do I configure Webhook MCP Server for Claude?

Add the server configuration to your Claude desktop config with a JSON block that sets the command (npx or docker) and passes WEBHOOK_URL as an environment variable. See the README for exact examples.

What optional parameters can I pass to the webhook?

You can include a message (custom text) and a url (an external link) in the webhook payload.

Can I use a webhook service other than Echobell?

Yes. The server sends a POST request to any HTTP webhook URL you provide. Echobell is only one example.

Does Webhook MCP Server support Docker?

Yes. A Docker image (noobnooc/webhook-mcp) is available and can be configured using the same environment variable.