Discord MCP

🚀 Discord MCP Server

A Model Context Protocol (MCP) server that supports the Discord API (JDA), enabling seamless integration between Discord bots and MCP-compatible applications (such as Claude Desktop).

Empower your AI assistant to interact seamlessly with Discord. Effortlessly manage channels, send messages, and retrieve server information. Elevate your Discord experience with powerful automation capabilities.

🚀 Quick Start

This server allows Discord bots to integrate with MCP-compatible applications, enabling seamless interaction between your AI assistant and Discord.

📦 Installation

Clone the Repository

git clone https://github.com/SaseQ/discord-mcp

Build the Project

⚠️ Important Note

You need to install Maven to use the mvn command. For complete installation instructions, refer to here.

cd discord-mcp
mvn clean package # The JAR file will be generated in the /target directory

Configure the AI Client

Many code editors and other AI clients use configuration files to manage MCP servers.

To configure the Discord MCP server, add the following content to your configuration file.

⚠️ Important Note

You need to create a Discord Bot token to use this server. For instructions on how to create a Discord Bot token, refer to here.

{
  "mcpServers": {
    "discord-mcp": {
      "command": "java",
      "args": [
        "-jar",
        "/absolute/path/to/discord-mcp-0.0.1-SNAPSHOT.jar"
      ],
      "env": {
        "DISCORD_TOKEN": "YOUR_DISCORD_BOT_TOKEN"
      }
    }
  }
}

🔧 Use Discord MCP Remotely via GitMCP

{
  "mcpServers": {
    "discord-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://gitmcp.io/SaseQ/discord-mcp"
      ],
      "env": {
        "DISCORD_TOKEN": "YOUR_DISCORD_BOT_TOKEN"
      }
    }
  }
}

For more configuration information, refer to here.

⚓ Automatically Install the Discord MCP Server via Smithery

npx -y @smithery/cli@latest install @SaseQ/discord-mcp --client claude

💻 Usage Examples

Server Information

• get_server_info: Retrieve detailed Discord server information

Message Management

• send_message: Send a message to a specific channel
• edit_message: Edit a message in a specific channel
• delete_message: Delete a message in a specific channel
• read_messages: Read the historical message records of a specific channel
• send_private_message: Send a private message to a specific user
• edit_private_message: Edit a private message of a specific user
• delete_private_message: Delete a private message of a specific user
• read_private_messages: Read the historical private message records of a specific user
• add_reaction: Add an emoji reaction to a specific message
• remove_reaction: Remove a specified emoji reaction from a message

Channel Management

• delete_channel: Delete a channel
• find_channel: Find the type and ID of a channel using its name and server ID
• list_channels: Get a list of all channels

Category Management

• create_category: Create a new category to accommodate channels
• delete_category: Delete a category
• find_category: Find the ID of a category using its name and server ID
• list_channels_in_category: Get a list of all channels in a specified category

Webhook Management

• create_webhook: Create a new webhook on a specific channel
• delete_webhook: Delete a webhook
• list_webhooks: List all webhooks on a specific channel
• send_webhook_message: Send a message via a webhook

For more detailed examples, refer to the Wiki.