Discord MCP Server

@hanweg

About Discord MCP Server

MCP server for discord bot

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-discord": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Discord MCP Server?

The Discord MCP Server is a Model Context Protocol (MCP) server that provides Discord integration capabilities to MCP clients like Claude Desktop. It allows AI assistants to interact with Discord servers through a set of defined tools.

How to use Discord MCP Server?

Install by setting up a Discord bot with required intents, cloning the repository, installing with uv, and configuring Claude Desktop (or another MCP client) to run the server using the uv command with your Discord bot token set as the DISCORD_TOKEN environment variable. An alternative installation via Smithery is also available.

Key features of Discord MCP Server

List and inspect Discord servers, channels, and members
Send, read, and react to messages in channels
Create and delete text channels
Add and remove roles for users
Moderate messages (delete and timeout users)

Use cases of Discord MCP Server

Automate server management tasks like creating channels and assigning roles
Monitor and respond to messages using an AI assistant
Moderate content by deleting messages or timing out users
Retrieve server information and member details on demand

FAQ from Discord MCP Server

What is the Discord MCP Server?

It is an MCP server that gives AI assistants the ability to interact with Discord servers by exposing Discord API functionality as tools.

What tools does the Discord MCP Server provide?

Tools are organized into categories: server information, message management, channel management, and role management. Examples include send_message, read_messages, create_text_channel, add_role, and moderate_message.

What are the prerequisites for using this server?

You need a Discord bot token from the Discord Developer Portal, with MESSAGE CONTENT INTENT, PRESENCE INTENT, and SERVER MEMBERS INTENT enabled. The bot must be invited to your server.

How do I install the Discord MCP Server?

You can either clone the repository and install manually with uv, or use the Smithery CLI command npx -y @smithery/cli install @hanweg/mcp-discord --client claude for automatic setup with Claude Desktop.

How does authentication work?

The server authenticates with Discord using a bot token provided via the DISCORD_TOKEN environment variable. It uses standard MCP transport (stdio) to communicate with the client.

Frequently asked questions

What is the Discord MCP Server?

It is an MCP server that gives AI assistants the ability to interact with Discord servers by exposing Discord API functionality as tools.

What tools does the Discord MCP Server provide?

Tools are organized into categories: server information, message management, channel management, and role management. Examples include `send_message`, `read_messages`, `create_text_channel`, `add_role`, and `moderate_message`.

What are the prerequisites for using this server?

You need a Discord bot token from the Discord Developer Portal, with MESSAGE CONTENT INTENT, PRESENCE INTENT, and SERVER MEMBERS INTENT enabled. The bot must be invited to your server.

How do I install the Discord MCP Server?

You can either clone the repository and install manually with `uv`, or use the Smithery CLI command `npx -y @smithery/cli install @hanweg/mcp-discord --client claude` for automatic setup with Claude Desktop.

How does authentication work?

The server authenticates with Discord using a bot token provided via the `DISCORD_TOKEN` environment variable. It uses standard MCP transport (stdio) to communicate with the client.