Discord

What is discord-mcp?

discord-mcp is a Model Context Protocol (MCP) server designed to integrate Discord with AI assistants and other MCP-compatible applications. It allows AI models to seamlessly interact with Discord, enabling powerful automation and enhanced Discord experiences.

How to use discord-mcp?

To use discord-mcp, you need to clone the repository, build the project using Maven, and then configure your AI client. This involves adding the discord-mcp server configuration to your client's configuration file and providing a Discord Bot token. Alternatively, you can use GitMCP for remote usage or Smithery for automatic installation.

Key features of discord-mcp

discord-mcp offers a comprehensive set of tools for managing Discord interactions:

Message Management:

• Send, edit, and delete messages in specific channels.
• Send, edit, and delete private messages to users.
• Read recent message history from channels and private chats.
• Add and remove reactions to messages.

Channel Management:

• Create and delete text channels.
• Find channels by name and server ID.
• List all channels.

Category Management:

• Create and delete channel categories.
• Find categories by name and server ID.
• List channels within a specific category.

Webhook Management:

• Create and delete webhooks.
• List webhooks on a channel.
• Send messages via webhooks.

Server Information:

• Get detailed Discord server information.

Use cases of discord-mcp

• AI Assistant Integration: Enable AI assistants to manage Discord servers, send messages, and retrieve information.
• Discord Automation: Automate various Discord tasks like message sending, channel management, and webhook interactions.
• Custom Discord Bots: Develop custom Discord bots with advanced functionalities leveraging the MCP protocol.

FAQ from discord-mcp

• What is MCP? MCP stands for Model Context Protocol, which is a protocol for AI models to interact with various services.
• Do I need Maven? Yes, Maven is required to build the project from source.
• How do I get a Discord Bot token? Instructions for creating a Discord Bot token can be found in the Discord.js guide.

📖 Description

A Model Context Protocol (MCP) server for the Discord API (JDA), allowing seamless integration of Discord Bot with MCP-compatible applications like Claude Desktop.

Enable your AI assistants to seamlessly interact with Discord. Manage channels, send messages, and retrieve server information effortlessly. Enhance your Discord experience with powerful automation capabilities.

🔬 Installation

Clone the repository

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

Build the project

NOTE: Maven installation is required to use the mvn command. Full instructions can be found here.

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

Configure AI client

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

The Discord MPC server can be configured by adding the following to your configuration file.

NOTE: You will need to create a Discord Bot token to use this server. Instructions on how to create a Discord Bot token can be found 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"
      }
    }
  }
}

🔧 GitMCP

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"
      }
    }
  }
}

More info and different configs here

⚓ Smithery

Install Discord MCP Server automatically via Smithery:

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

🛠️ Available Tools

Server Information

• get_server_info: Get detailed discord server information

Message Management

• send_message: Send a message to a specific channel
• edit_message: Edit a message from a specific channel
• delete_message: Delete a message from a specific channel
• read_messages: Read recent message history from a specific channel
• send_private_message: Send a private message to a specific user
• edit_private_message: Edit a private message from a specific user
• delete_private_message: Delete a private message from a specific user
• read_private_messages: Read recent message history from a specific user
• add_reaction: Add a reaction (emoji) to a specific message
• remove_reaction: Remove a specified reaction (emoji) from a message

Channel Management

• create_text_channel: Create text a channel
• delete_channel: Delete a channel
• find_channel: Find a channel type and ID using name and server ID
• list_channels: List of all channels

Category Management

• create_category: Create a new category for channels
• delete_category: Delete a category
• find_category: Find a category ID using name and server ID
• list_channels_in_category: List of channels in a specific category

Webhook Management

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

A more detailed examples can be found in the Wiki.