🪝 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

1. Open Dive Desktop
2. Click "+ Add MCP Server"
3. Paste the config provided above
4. 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 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!

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. 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