Discord MCP

Discord MCP

Seamlessly integrate AI and Discord through the Model Context Protocol.

116
Stars
23
Forks
116
Watchers
1
Issues
Discord MCP is a server implementing the Model Context Protocol (MCP) for the Discord API using JDA, enabling AI assistants and applications to interact with Discord servers. It facilitates the management of channels, messages, and server information, supporting automation and integration with MCP-compatible clients such as Claude Desktop. Installation is supported via Docker and manual builds with Maven, providing flexibility for deployment. It enables enhanced automation and context management for Discord bots via the standardized MCP interface.

Key Features

MCP server implementation for Discord
Support for channel management
Ability to send and receive messages
Discord server information retrieval
Integration with MCP-compatible clients
Docker-based deployment
Manual Java/Maven installation support
Environment variable configuration
Automation of Discord bot tasks
Open-source under MIT license

Use Cases

Automating Discord server management tasks via AI assistants
Integrating Discord bots with context-aware AI workflows
Enabling AI-powered interaction and moderation on Discord servers
Facilitating communication between AI agents and Discord communities
Standardized management of Discord channels and messages for AI clients
Prototyping intelligent Discord bots that use MCP
Augmenting collaborative tools with Discord context integration
Developing AI copilot features for Discord administrators
Enhancing Discord notifications and alerts using external AI systems
Running Discord bot automation in Dockerized or self-hosted environments

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

► 🐳 Docker Installation (Recommended)

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

json
{
  "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

bash
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.

bash
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.

json
{
  "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:

bash
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.

json
{
  "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.

bash
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

User Management

Message Management

Channel Management

Category Management

Webhook Management

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.

Star History

Star History Chart

Repository Owner

SaseQ
SaseQ

User

Repository Details

Language Java
Default Branch main
Size 75 KB
Contributors 4
License MIT License
MCP Verified Nov 11, 2025

Programming Languages

Java
99.33%
Dockerfile
0.67%

Tags

Topics

ai claude discord discord-bot java mcp mcp-server n8n

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Unichat MCP Server

    Unichat MCP Server

    Universal MCP server providing context-aware AI chat and code tools across major model vendors.

    Unichat MCP Server enables sending standardized requests to leading AI model vendors, including OpenAI, MistralAI, Anthropic, xAI, Google AI, DeepSeek, Alibaba, and Inception, utilizing the Model Context Protocol. It features unified endpoints for chat interactions and provides specialized tools for code review, documentation generation, code explanation, and programmatic code reworking. The server is designed for seamless integration with platforms like Claude Desktop and installation via Smithery. Vendor API keys are required for secure access to supported providers.

    • 37
    • MCP
    • amidabuddha/unichat-mcp-server
  • Kanboard MCP Server

    Kanboard MCP Server

    MCP server for seamless AI integration with Kanboard project management.

    Kanboard MCP Server is a Go-based server implementing the Model Context Protocol (MCP) for integrating AI assistants with the Kanboard project management system. It enables users to manage projects, tasks, users, and workflows in Kanboard directly via natural language commands through compatible AI tools. With built-in support for secure authentication and high performance, it facilitates streamlined project operations between Kanboard and AI-powered clients like Cursor or Claude Desktop. The server is configurable and designed for compatibility with MCP standards.

    • 15
    • MCP
    • bivex/kanboard-mcp
  • mcp-server-docker

    mcp-server-docker

    Natural language management of Docker containers via Model Context Protocol.

    mcp-server-docker enables users to manage Docker containers using natural language instructions through the Model Context Protocol. It allows composing, introspecting, and debugging containers, as well as managing persistent Docker volumes. The tool is suitable for server administrators, tinkerers, and AI enthusiasts looking to leverage LLM capabilities for Docker management. Integration with tools like Claude Desktop and Docker ensures flexible deployment and easy connectivity to Docker engines.

    • 648
    • MCP
    • ckreiling/mcp-server-docker
  • CircleCI MCP Server

    CircleCI MCP Server

    Enable LLM-driven automation for CircleCI with the Model Context Protocol.

    CircleCI MCP Server is an implementation of the Model Context Protocol (MCP) designed to bridge CircleCI with large language models and AI assistants. It supports integration with tools like Cursor IDE, Windsurf, Copilot, and VS Code, allowing users to interact with CircleCI using natural language. The server can be deployed locally via NPX or Docker and remotely, making CircleCI workflows accessible and manageable through standardized protocol operations.

    • 69
    • MCP
    • CircleCI-Public/mcp-server-circleci
  • Insforge MCP Server

    Insforge MCP Server

    A Model Context Protocol server for seamless integration with Insforge and compatible AI clients.

    Insforge MCP Server implements the Model Context Protocol (MCP), enabling smooth integration with various AI tools and clients. It allows users to configure and manage connections to the Insforge platform, providing automated and manual installation methods. The server supports multiple AI clients such as Claude Code, Cursor, Windsurf, Cline, Roo Code, and Trae via standardized context management. Documentation and configuration guidelines are available for further customization and usage.

    • 3
    • MCP
    • InsForge/insforge-mcp
  • Codex MCP Server

    Codex MCP Server

    An MCP-compatible server delivering enriched blockchain data for AI models.

    Codex MCP Server implements the Model Context Protocol to provide enriched blockchain data from Codex. It is compatible with MCP clients such as Claude Desktop and Claude CLI, allowing seamless integration in AI workflows that require blockchain context. Users can run the server locally or via npx, and configure it for various MCP-compatible tools using their Codex API key.

    • 20
    • MCP
    • Codex-Data/codex-mcp
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results