Discord Notifications

Provides Discord notifications, channel management, and interactive questions for MCP agents via a Python-based Discord MCP server.

python

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "skitzo2000-mcp-discord-notify": {
      "command": "python",
      "args": [
        "/absolute/path/to/mcp-discord-notify/main.py"
      ],
      "env": {
        "DISCORD_CHANNELS": "{\"general\":\"123\",\"alerts\":\"456\"}",
        "DISCORD_GUILD_ID": "YOUR_GUILD_ID",
        "DISCORD_BOT_TOKEN": "YOUR_BOT_TOKEN"
      }
    }
  }
}

This MCP server enables AI coding agents to interact with Discord by sending notifications to multiple channels, creating new channels for projects, and posting questions with optional two-way responses. It streamlines communication and collaboration by integrating Discord directly into your automated workflows.

How to use

You will run this server locally or in your environment and connect it to your MCP client. Use the provided tools to manage channels and deliver messages to Discord from your agents. The server supports sending simple notifications, creating channels on demand, and posting questions that can be answered by your agents with yes/no, multiple choice, or extended text responses. For questions with buttons, you can enable interactive responses and optionally wait for the first reply.

How to install

Prerequisites: Python 3.10 or newer.

Install and run the server locally with these steps.

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

Configure MCP client integration

The server runs as a standard MCP stdio endpoint. Configure your MCP client to execute the Python entry point with the proper environment variables.

Configuring environment and channels

Environment variables you can set for startup include the Discord bot token, the target guild (server) ID, and an optional channels map that assigns human-friendly keys to Discord channel IDs.

Cursor example (MCP settings)

Use a cursor configuration to point to the local Python process that runs the MCP server. The example below shows how to reference the main script and pass environment variables.

Available tools

list_channels

List channels in a guild along with their IDs and optional keys assigned in the config.

send_notification

Send a message to a channel by ID or by a friendly key defined in channels.json or DISCORD_CHANNELS.

create_channel

Create a new text channel in the connected guild and optionally register a key for future use by channel name.

send_question

Post a question with yes/no, multiple choice, or extended answer; optionally wait for the first response.

Built by

VeilStrat

AI signals for GTM teams