jaewilson07/discord_mcp

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_members: List server members and their roles
• 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
• moderate_message: Delete messages and timeout users

Channel Management

• create_text_channel: Create a new text channel
• delete_channel: Delete an existing channel
• create_category: Create a new category channel
• move_channel: Move a channel to a different category or remove it from a category

Event Management

• create_scheduled_event: Create a scheduled event for a server (supports external, voice, and stage events)
• edit_scheduled_event: Edit an existing scheduled event (update name, description, times, location, channel, or status)

Role Management

• add_role: Add a role to a user
• remove_role: Remove a role from a user

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/hanweg/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):

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

Installing via Smithery

To install Discord Server for Claude Desktop automatically via Smithery:

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

Mobile Development

Want to continue development from your phone? Check out the for options including:

• GitHub Codespaces (cloud IDE)
• Mobile Git apps for quick edits
• Termux for Android development
• Remote desktop access

Quick start: Enable GitHub Codespaces on this repo and start coding from any device!

License

MIT License - see LICENSE file for details.