🪝 mcp-webhook

A powerful MCP server that enables webhook messaging capabilities for your AI agents

Send messages to any webhook endpoint through Claude, Dive, and other MCP-compatible AI systems. Perfect for notifications, alerts, and automated messaging.

Features • Installation • Tools • Usage • Configuration

✨ Features

🌐 Generic Webhook Support

Works with any webhook endpoint
Compatible with Discord, Slack, Mattermost
Custom HTTP POST requests
JSON payload formatting

🎨 Customization

Custom display name (username)
Avatar URL support
Flexible message content
Easy integration with any platform

🔌 MCP Integration

Works with Dive Desktop
Claude Desktop compatible
Cursor, VS Code support
Any MCP-compatible LLM

🛡️ Simple & Secure

Minimal configuration
Environment variable support
No tracking or analytics
MIT licensed

🚀 Installation

Getting Started

Add the following config to your MCP client:

{
  "mcpServers": {
    "webhook": {
      "command": "npx",
      "args": ["-y", "@kevinwatt/mcp-webhook"],
      "env": {
        "WEBHOOK_URL": "your-webhook-url"
      }
    }
  }
}

MCP Client Configuration

Dive

Open Dive Desktop
Click "+ Add MCP Server"
Paste the config provided above
Click "Save" and you're ready!

Claude Code

Use the Claude Code CLI to add the webhook MCP server (guide):

claude mcp add webhook -- npx @kevinwatt/mcp-webhook

Then set the webhook URL in your environment or config.

Claude Desktop

Add to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "webhook": {
      "command": "npx",
      "args": ["-y", "@kevinwatt/mcp-webhook"],
      "env": {
        "WEBHOOK_URL": "your-webhook-url"
      }
    }
  }
}

Cursor

Go to Cursor Settings -> MCP -> New MCP Server. Use the config provided above.

VS Code / Copilot

Install via the VS Code CLI:

code --add-mcp '{"name":"webhook","command":"npx","args":["-y","@kevinwatt/mcp-webhook"],"env":{"WEBHOOK_URL":"your-webhook-url"}}'

Or follow the MCP install guide with the standard config from above.

Windsurf

Follow the configure MCP guide using the standard config from above.

Cline

Follow Cline MCP configuration guide and use the config provided above.

Warp

Go to Settings | AI | Manage MCP Servers -> + Add to add an MCP Server. Use the config provided above.

JetBrains AI Assistant

Go to Settings | Tools | AI Assistant | Model Context Protocol (MCP) -> Add. Use the config provided above.

Installing via Smithery

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

npx -y @smithery/cli install @kevinwatt/mcp-webhook --client claude

Manual Installation

npm install -g @kevinwatt/mcp-webhook

🛠️ Available Tools

Tool Description

Tool	Description
`send_message`	Send a message to the configured webhook endpoint Parameters: `content` (string, required): Message content to send `username` (string, optional): Custom display name `avatar_url` (string, optional): Custom avatar URL Returns: Success/failure status

send_message

Send a message to the configured webhook endpoint

Parameters:
- content (string, required): Message content to send
- username (string, optional): Custom display name
- avatar_url (string, optional): Custom avatar URL
Returns: Success/failure status

💡 Usage Examples

Basic Messages

"Send a message to webhook: Hello World!"
"Send 'Build completed successfully' to the webhook"
"Notify the team: Deployment finished"

Custom Username

"Send a message with username 'Deploy Bot': Production update complete"
"Send content='Server restarted', username='System Monitor'"

With Avatar

"Send a message with custom avatar: content='Alert!', avatar_url='https://example.com/alert.png'"

Automation Examples

"Send a webhook message when the build completes"
"Notify via webhook: All tests passed!"
"Send deployment status to the webhook channel"

🔧 Configuration

Environment Variables

| Variable | Description | Required | |----------|-------------|----------| | WEBHOOK_URL | The webhook endpoint URL | Yes |

Example Configurations

Discord Webhook:

{
  "env": {
    "WEBHOOK_URL": "https://discord.com/api/webhooks/..."
  }
}

Slack Incoming Webhook:

{
  "env": {
    "WEBHOOK_URL": "https://hooks.slack.com/services/..."
  }
}

Mattermost Webhook:

{
  "env": {
    "WEBHOOK_URL": "https://your-mattermost.com/hooks/..."
  }
}

🏗️ Architecture

Built With

MCP SDK - Model Context Protocol
Axios - HTTP client
TypeScript - Type safety and developer experience

Key Features

✅ Simple: Minimal setup, just provide a webhook URL
✅ Flexible: Works with any webhook-compatible service
✅ Type-Safe: Full TypeScript support
✅ Lightweight: Minimal dependencies

🤝 Contributing

Contributions are welcome!

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Anthropic - For the Model Context Protocol
Dive - MCP-compatible AI platform

📚 Related Projects

MCP Servers - Official MCP server implementations
Dive Desktop - AI agent platform

⬆ Back to Top

MCP Servers