discord-webhook-mcp

An MCP server to send notifications from AI agents to Discord via Discord webhooks.

• 日本語のマニュアル

How to Get Discord Webhook URL

Here are the steps to obtain a Discord Webhook URL:

• Open the target server in Discord.

• Choose the text channel where you want to send webhooks.

• Click the gear icon next to the channel name, or right-click the channel, to open "Edit Channel".

• Select "Integrations" from the left menu.

• Open "Webhooks".

• Click "New Webhook" or "Create Webhook".

• Set a name for the Webhook.

• Verify that the posting channel is correct.

• Set an icon image if necessary.

• Click "Copy Webhook URL".

• Click "Save Changes".

Setup

You can configure the Discord Webhook URL in one of two ways:

1. Set the DISCORD_WEBHOOK_URL environment variable.

2. Pass it as a command-line argument using --url=YOUR_WEBHOOK_URL (or --url YOUR_WEBHOOK_URL).

AI Agent Installation

Use the following steps to install the server to your AI agent of choice.

Install to Codex CLI

codex mcp add discord-webhook \
    -- npx -y @kujirahand/discord-webhook-mcp \
    --url=https://discord.com/api/webhooks/xxxxx

Install to Claude Code

claude mcp add discord-webhook \
    -- npx -y @kujirahand/discord-webhook-mcp \
    --url=https://discord.com/api/webhooks/xxxxx

Install to Clude Desktop

Edit the claude_desktop_config.json file and add the following configuration:

{
  "mcpServers": {
    "discord-webhook": {
      "command": "npx",
      "args": [
        "-y",
        "@kujirahand/discord-webhook-mcp",
        "--url=https://discord.com/api/webhooks/xxxxx"
      ]
    }
  }
}

Install to Antigravity CLI

Add the following configuration to your ~/.gemini/config/mcp_config.json file:

{
  "mcpServers": {
    "discord-webhook": {
      "command": "npx",
      "args": ["-y", "@kujirahand/discord-webhook-mcp"],
      "env": {
        "DISCORD_WEBHOOK_URL": "https://discord.com/api/webhooks/xxxxx"
      }
    }
  }
}

Available Tools

1. send_message

Sends a text message to the Discord channel.

• Arguments:

  • message (string, required): The text message.

  • username (string, optional): Override the webhook bot's username.

  • avatar_url (string, optional): Override the webhook bot's avatar.

2. send_image

Uploads an image file to the Discord channel.

• Arguments:

  • image_path (string, required): Local path to the image file.

  • message (string, optional): Accompanying text message.

  • username (string, optional): Override the webhook bot's username.

  • avatar_url (string, optional): Override the webhook bot's avatar.