Discord Notifications MCP Server

MCP server that gives AI coding agents access to Discord: send notifications to multiple channels, create channels for new projects, and post questions (yes/no, multiple choice, extended answer) with optional two-way response.

Requirements

Python 3.10+
A Discord Bot: create an application, add a bot, copy the token. Invite the bot to your server with scopes: bot, permissions: Send Messages, View Channels, Manage Channels, Read Message History, Use Slash Commands (if needed). For questions with buttons, enable Message Content Intent in the Bot settings.

Config

Env / file	Purpose
`DISCORD_BOT_TOKEN` or `DISCORD_TOKEN`	Bot token (required).
`DISCORD_GUILD_ID`	Default guild ID for `list_channels` when guild_id is omitted.
`DISCORD_CHANNELS`	JSON map of channel keys → IDs, e.g. `{"general": "123","alerts": "456"}`.
`DISCORD_MCP_CONFIG_DIR`	Directory for `channels.json` (default: current dir).
`channels.json`	Same as `DISCORD_CHANNELS`: `{"general": 123, "alerts": 456}`.

Channel keys let agents use send_notification("general", "Done.") instead of raw channel IDs.

Install and run

cd mcp-discord-notify
pip install -r requirements.txt
export DISCORD_BOT_TOKEN=your_bot_token
# optional: export DISCORD_GUILD_ID=your_server_id
# optional: create channels.json or set DISCORD_CHANNELS
python main.py

The server runs over stdio (JSON-RPC). Configure your MCP client to run:

Command: python (or uv run python)
Args: ["/absolute/path/to/mcp-discord-notify/main.py"]
Env: DISCORD_BOT_TOKEN=... (and optionally DISCORD_GUILD_ID, DISCORD_CHANNELS)

Cursor

Add to MCP settings (or .cursor/mcp.json):

{
  "mcpServers": {
    "discord-notifications": {
      "command": "python",
      "args": ["/home/skitz0/Documents/claude-cord/mcp-discord-notify/main.py"],
      "env": {
        "DISCORD_BOT_TOKEN": "your_bot_token",
        "DISCORD_GUILD_ID": "your_guild_id"
      }
    }
  }
}

Use the real path to main.py and set the env vars (or rely on your shell env).

Tools

Tool	Description
list_channels	List channels in a guild (id, name, key if in config).
send_notification	Send a message to a channel (by ID or key).
create_channel	Create a text channel; optional `register_key` to save for future use by name.
send_question	Post a question with yes/no, multiple choice, or extended answer; optionally wait for first response.

Questions (two-way)

yes_no: Two buttons (Yes / No).
multiple_choice: Buttons per option; pass options as JSON array string, e.g. ["A","B","C"].
extended: "Reply" button opens a modal for long-form text.

Set wait_timeout_seconds (default 300); the tool returns the first response or timeout.

New project channels

Use create_channel with register_key so agents can target the channel by name. See the project skill: .cursor/skills/discord-notifications/SKILL.md.

Discord Notifications MCP Server

Discord Notifications MCP Server

Requirements

Config

Install and run

Cursor

Tools

Questions (two-way)

New project channels

Reviews