Discord MCP Server

A Model Context Protocol (MCP) server that provides Discord integration capabilities to MCP clients like Claude Desktop.

Available Tools

Server Information

• list_servers: List available servers

• get_server_info: Get detailed server information

• get_channels: List channels in a server

• list_roles: View all roles in a server

• list_members: List server members and their roles

• list_invites: Display active invite links

• list_bans: Show banned users

• get_user_info: Get detailed information about a user

Message Management

• send_message: Send a message to a channel

• read_messages: Read recent message history

• add_reaction: Add a reaction to a message

• add_multiple_reactions: Add multiple reactions to a message

• remove_reaction: Remove a reaction from a message

• pin_message: Pin a message in a channel

• unpin_message: Unpin a pinned message

• bulk_delete_messages: Remove batches of recent messages

• moderate_message: Delete messages and timeout users

Channel Management

• create_text_channel: Create a new text channel

• create_voice_channel: Create a new voice channel

• create_stage_channel: Create a stage channel for events

• create_category: Create a channel category

• update_channel: Modify channel settings

• delete_channel: Delete an existing channel

• create_invite: Generate invite links for channels

Role Management

• create_role: Create new roles

• edit_role: Update existing roles

• delete_role: Remove roles

• add_role: Add a role to a user

• remove_role: Remove a role from a user

Member Management

• kick_member: Remove a member from the server

• ban_member: Ban a member and optionally delete recent messages

• unban_member: Lift a ban for a user

• timeout_member: Apply or clear communication timeouts

Related MCP server: discord-mcp

Installation

1. Set up your Discord bot:

   • Create a new application at Discord Developer Portal

   • Create a bot and copy the token

   • Enable required privileged intents:

     • MESSAGE CONTENT INTENT

     • PRESENCE INTENT

     • SERVER MEMBERS INTENT

   • Invite the bot to your server using OAuth2 URL Generator

2. Clone and install the package:

# Clone the repository
git clone https://github.com/wowjinxy/mcp-discord.git
cd mcp-discord

# Create and activate virtual environment
uv venv
.venv\Scripts\activate # On macOS/Linux, use: source .venv/bin/activate

### If using Python 3.13+ - install audioop library: `uv pip install audioop-lts`

# Install the package
uv pip install -e .

3. Configure Claude Desktop (%APPDATA%\Claude\claude_desktop_config.json on Windows, ~/Library/Application Support/Claude/claude_desktop_config.json on macOS) so it runs the installed entry point via uv. Provide your Discord token using either the MCP session configuration or the DISCORD_TOKEN/discordToken environment variable:

    "discord": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\PATH\\TO\\mcp-discord",
        "run",
        "mcp-discord"
      ],
      "session_config": {
        "discordToken": "your_bot_token"
      }
    }

Alternatively, export the token before starting Claude Desktop and omit the session_config block:

export DISCORD_TOKEN=your_bot_token
## or use the camelCase environment name supported by some clients
export discordToken=your_bot_token

Installing via Smithery

To install Discord Server for Claude Desktop automatically via Smithery, ensure you supply the Discord token through your MCP client configuration (for example by setting discordToken in the session config) or by exporting DISCORD_TOKEN/discordToken before starting the client:

npx -y @smithery/cli install @wowjinxy/mcp-discord-manager --client claude

License

MIT License - see LICENSE file for details.