mcp webhook
🪝 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
|
🎨 Customization
|
🔌 MCP Integration
|
🛡️ Simple & Secure
|
🚀 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 |
|---|---|
send_message |
Send a message to the configured webhook endpoint
|
💡 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
📚 Related Projects
- MCP Servers - Official MCP server implementations
- Dive Desktop - AI agent platform