mcp-discord

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides Discord integration capabilities including server management, message management, channel management, role management, and webhook management.

Discord MCP Server

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

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

Chat Workflow

  • await_mention: Wait for the bot to be mentioned and return a list of channel IDs where mentions have recently occurred

Chat Workflow

Supports a chat workflow:

  1. Wait for mentions using await_mention
  2. Read recent messages with read_messages
  3. Process the messages and determine an appropriate response
  4. Send a response using send_message
  5. Repeat as needed

See the included chat.md

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" "DISCORD_TIMEOUT": "60.0" } }

License

MIT License - see LICENSE file for details.

-
security - not tested
A
license - permissive license
-
quality - not tested

Provides Discord integration capabilities to MCP clients like Claude Desktop.

  1. Available Tools
    1. Server Information
    2. Message Management
    3. Channel Management
    4. Role Management
    5. Webhook Management
    6. Chat Workflow
  2. Installation
    1. Installing via Smithery
  3. License