🪝 mcp-webhook

<div align="center">

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

</div>

---

✨ Features

<table> <tr> <td width="50%">

🌐 Generic Webhook Support

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

</td> <td width="50%">

🎨 Customization

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

</td> </tr> <tr> <td width="50%">

🔌 MCP Integration

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

</td> <td width="50%">

🛡️ Simple & Secure

• Minimal configuration
• Environment variable support
• No tracking or analytics
• MIT licensed

</td> </tr> </table>

<a href="https://glama.ai/mcp/servers/ijmd1ia5zg"><img width="380" height="200" src="https://glama.ai/mcp/servers/ijmd1ia5zg/badge" alt="Webhook Server MCP server" /></a>

---

🚀 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

<details open> <summary><strong>Dive</strong></summary>

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

</details> <details> <summary><strong>Claude Code</strong></summary>

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.

</details> <details> <summary><strong>Claude Desktop</strong></summary>

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"
      }
    }
  }
}

</details> <details> <summary><strong>Cursor</strong></summary>

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

</details> <details> <summary><strong>VS Code / Copilot</strong></summary>

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.

</details> <details> <summary><strong>Windsurf</strong></summary>

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

</details> <details> <summary><strong>Cline</strong></summary>

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

</details> <details> <summary><strong>Warp</strong></summary>

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

</details> <details> <summary><strong>JetBrains AI Assistant</strong></summary>

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

</details>

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

<table> <tr> <th width="30%">Tool</th> <th width="70%">Description</th> </tr> <tr> <td><code>send_message</code></td> <td>

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

</td> </tr> </table>

---

💡 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

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

---

<div align="center">

⬆ Back to Top

</div>