discord-mcp

Name: discord-mcp
Availability: InStock
Author: SaseQ

discord-mcp is a Java library that implements the Model Context Protocol on the Discord platform. This library provides functionalities for efficient communication between servers, enabling developers to easily build Discord bots and applications. It particularly enhances API integration, offering tools to improve user experience.

GitHub

GitHub Stars

User Rating

Not Rated

Forks

Issues

Views

Favorites

README

📖 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",
        "DISCORD_GUILD_ID": "OPTIONAL_DEFAULT_SERVER_ID"
      }
    }
  }
}

The DISCORD_GUILD_ID environment variable is optional. When provided, it sets a default Discord server ID so any tool that accepts a guildId parameter can omit it.

🔧 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",
        "DISCORD_GUILD_ID": "OPTIONAL_DEFAULT_SERVER_ID"
      }
    }
  }
}

Set DISCORD_GUILD_ID here as well if you want to automatically target a specific server. 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

If DISCORD_GUILD_ID is set, the guildId parameter becomes optional for all tools below.

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
get_user_id_by_name: Get a Discord user's ID by username in a guild for ping usage <@id>
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