Discord Notification MCP Server
About
Simple MCP server to send you notifications on discord
Details
- Author
- kstonekuan
- GitHub stars
- 8
- Downloads
- 388
- Categories
- Communication
Jump to
- MCP Tool send_discord_message for notifications
- Serverless deployment on Cloudflare Workers
- Secure credential storage via Cloudflare secrets
- Dual transport: SSE and Streamable HTTP
- Durable Objects for state management
- Rich formatting with embeds, TTS, and mention controls
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Discord Notification MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Clone the repository, install dependencies with pnpm install, create a Discord webhook URL, and set it as the WEBHOOK_URL secret. Deploy to Cloudflare Workers with pnpm run deploy, then add the server to Claude Code using claude mcp add discord-notify https://your-worker-name.workers.dev/sse -t sse. Once configured, use the send_discord_message tool to send notifications.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"discord notification mcp server": {
"discord-notification-mcp": {
"command": "npx",
"args": [
"wrangler",
"secret",
"put",
"WEBHOOK_URL"
]
}
}
}
}McpServers
{
"discord-notification-mcp": {
"command": "npx",
"args": [
"wrangler",
"secret",
"put",
"WEBHOOK_URL"
]
}
}Discord Notification MCP Server
<div align="center">
An MCP (Model Context Protocol) server that sends notifications to Discord when Claude Code completes tasks. Built with TypeScript using the Cloudflare Agents SDK and deployable on Cloudflare Workers.
</div>
Features
- 🤖 MCP Tool: Provides a send_discord_message tool for sending notifications
- 🚀 Cloudflare Workers: Runs serverless with global distribution
- 🔐 Secure: Uses Cloudflare secrets for credentials
- 🌐 Dual Transport: Supports both SSE and Streamable HTTP for maximum compatibility
- 💾 Durable Objects: State management required by McpAgent
- 💬 Rich Formatting: Supports embeds, TTS messages, and mention controls
Architecture
This server implements the MCP specification using Cloudflare's Agents SDK:
- GET /sse: SSE endpoint for MCP communication
- POST /mcp: Streamable HTTP endpoint for MCP communication
- Built with TypeScript, MCP SDK, and Cloudflare Agents SDK
- Proper JSON-RPC 2.0 error handling
- Durable Objects for stateful connections (required by McpAgent)
- Node.js compatibility mode enabled
Setup
Prerequisites
1. Discord Webhook: Create a webhook in your Discord channel:
- Right-click on the channel → Edit Channel → Integrations → Webhooks
- Click "New Webhook" and copy the webhook URL
2. Cloudflare Account: Sign up at cloudflare.com
Installation
1. Clone this repository
2. Install dependencies:
pnpm install
Configuration
1. Create a .dev.vars file from the example:
cp .dev.vars.example .dev.vars
Then edit
.dev.vars with your webhook URL. This file is used for both local development and deployment.
2. For production deployment, set up Cloudflare secrets:
npx wrangler secret put WEBHOOK_URL
3. Update wrangler.toml with your worker name if desired
Deployment
Deploy to Cloudflare Workers:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
