mcp-discord

mcp-discord

77
communication

The project is an MCP server designed to facilitate Discord integration with MCP clients like Claude Desktop. It offers features like server information retrieval, message management, channel, role and webhook creation, and more, providing comprehensive management capabilities.

Discord MCP Server

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

mcp-discord MCP server

Available Tools

Server Information

  • get_server_info: Get detailed server information
  • list_members: List server members and their roles

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

Role Management

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

Webhook Management

  • create_webhook: Create a new webhook
  • list_webhooks: List webhooks in a channel
  • send_webhook_message: Send messages via webhook
  • modify_webhook: Update webhook settings
  • delete_webhook: Delete a webhook

Installation

Installing via Smithery

To install Discord Server for Claude Desktop automatically via Smithery:

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

  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

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

# Install the package
uv pip install -e .
  1. 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"
      }
    }

License

MIT License - see LICENSE file for details.