Discord MCP

What is Discord MCP about?

Discord MCP provides a Model Context Protocol server that connects the Discord API (via JDA) to AI tools such as Claude Desktop. It exposes a set of remote‑callable tools that let assistants interact with Discord servers, channels, users, messages, categories, and webhooks.

How to use Discord MCP?

1. Docker (recommended) – Run the provided Docker image, passing DISCORD_TOKEN (required) and optionally DISCORD_GUILD_ID.
2. Manual Java execution – Build the project with Maven, then start the JAR with the same environment variables.
3. Add to MCP client – Insert the Docker or Java command into the client’s mcpServers configuration (e.g., Cursor, Smithery, Claude Code).

Key features

• Server information retrieval
• User lookup and private messaging (send, edit, delete, read)
• Channel message management (send, edit, delete, read, react)
• Text channel and category creation, deletion, lookup, and listing
• Webhook creation, deletion, listing, and message sending
• Optional default guild ID makes guildId parameter optional for all tools

Use cases

• Automating community moderation and announcements via AI agents
• Enabling AI‑driven chat assistants to respond in Discord channels
• Synchronizing external workflows (e.g., n8n) with Discord events
• Building custom bots that leverage large language model reasoning for message generation
• Providing remote support tools that can read/write private messages on behalf of users

FAQ

Q: Do I need a Discord bot token? A: Yes. Create a bot in the Discord Developer Portal and grant it the required permissions.

Q: Is the DISCORD_GUILD_ID required? A: No. It is optional; when set, it becomes the default server for all tool calls.

Q: Can I run the server without Docker? A: Absolutely. Clone the repository, build with Maven, and execute the JAR with the appropriate environment variables.

Q: Which clients are supported? A: Any MCP‑compatible client, including Claude Code, Cursor, Smithery, and custom integrations.

Q: Where can I find more examples? A: Detailed usage samples are available in the project’s Wiki on GitHub.

📖 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

► 🐳 Docker Installation (Recommended)

NOTE: Docker installation is required. Full instructions can be found on docker.com.

{
  "mcpServers": {
    "mcp-server": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN>",
        "-e", "DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID>",
        "saseq/discord-mcp:latest"
      ]
    }
  }
}

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.

Install Discord MCP Server automatically via Smithery:

npx -y @smithery/cli@latest install @SaseQ/discord-mcp --client <CLIENT_NAME> --key <YOUR_SMITHERY_KEY>

Go to: Settings -> Cursor Settings -> MCP -> Add new global MCP server

Pasting the following configuration into your Cursor ~/.cursor/mcp.json file is the recommended approach. You may also install in a specific project by creating .cursor/mcp.json in your project folder. See Cursor MCP docs for more info.

{
  "mcpServers": {
    "mcp-server": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN>",
        "-e", "DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID>",
        "saseq/discord-mcp:latest"
      ]
    }
  }
}

Run this command. See Claude Code MCP docs for more info.

claude mcp add mcp-server -- docker run --rm -i -e DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN> -e DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID> saseq/discord-mcp:latest

🛠️ Available Tools

Server Information

• get_server_info: Get detailed discord server information

User Management

• 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

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
• 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

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

A more detailed examples can be found in the Wiki.