home / mcp / discord notification mcp server

Discord Notification MCP Server

Simple MCP server to send you notifications on discord

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "kstonekuan-discord-notification-mcp": {
      "url": "https://your-worker-name.workers.dev/sse",
      "headers": {
        "WEBHOOK_URL": "YOUR_WEBHOOK_URL"
      }
    }
  }
}

You deploy and run a Cloudflare Workers MCP server that sends notifications to Discord whenever Claude Code completes tasks. It supports reliable transport through SSE and Streamable HTTP, uses durable state for MCP connections, and formats messages with embeds and mention controls to keep your team informed.

How to use

Connect Claude Code to the Discord Notification MCP Server using the provided SSE transport endpoints. You will configure Claude Code to point to the server’s /sse endpoint for real-time updates as tasks run. Use the send_discord_message tool to post rich notifications to your Discord channel when tasks finish, encounter errors, or require human input.

How to install

Prerequisites: You need a Discord webhook, and an environment capable of running Cloudflare Workers with the Wrangler tool.

1. Create a Discord webhook in your channel: right-click the channel → Edit Channel → Integrations → Webhooks, then choose New Webhook and copy the URL.

2. Sign up for a Cloudflare account at cloudflare.com.

3. Install dependencies locally.

pnpm install

Production and local deployment

Set the Discord webhook URL as a Cloudflare secret and deploy your worker. Use the same secret in local development for consistency.

# First set secrets
npx wrangler secret put WEBHOOK_URL

# Then deploy
pnpm run deploy

Claude Code configuration

Add the MCP server to Claude Code using the SSE transport. Production and local examples are shown below.

# For production deployment (SSE)
claude mcp add discord-notify https://your-worker-name.workers.dev/sse -t sse

# For local development
claude mcp add discord-notify http://localhost:8787/sse -t sse

Verification and health

Verify the configuration by listing MCP connections and testing the SSE endpoint directly.

claude mcp list

# Test SSE endpoint
curl -N http://localhost:8787/sse

Available tools

send_discord_message

Tool to send a notification message to Discord with content, optional embeds, TTS, and allowed_mentions controls.