MCP Discord Extended

Discord MCP server with advanced server management capabilities

Extended Model Context Protocol server for Discord. Forked from barryyip0625/mcp-discord with additional features for complete server management.

Features

| Category | Capabilities | |----------|-------------| | Roles | Create, edit, delete, assign, remove roles with full permission control | | Permissions | Set, get, remove channel permission overwrites for roles/members | | Channels | Text, voice, categories - create, edit, delete, organize | | Members | List members, get detailed info, manage roles | | Messages | Send, read, edit, delete, bulk delete, pin, move | | Reactions | Add, remove, multiple reactions | | Forums | Create posts, reply, manage forum channels | | Webhooks | Create, edit, delete, send messages via webhooks | | Batch | Execute multiple operations in a single call |

Quick Start

Requirements

• Node.js v20.0.0 or higher
• Discord Bot with Administrator permission
• Bot Token from Discord Developer Portal

Installation

git clone https://github.com/Kogollones/mcp-discord.git
cd mcp-discord
npm install

Configuration

Add to your Claude Desktop (claude_desktop_config.json) or Claude Code settings:

{
  "mcpServers": {
    "discord": {
      "command": "node",
      "args": [
        "C:/path/to/mcp-discord/build/index.js",
        "--config",
        "YOUR_DISCORD_BOT_TOKEN"
      ]
    }
  }
}

Tools Reference

Server & Login

| Tool | Description | |------|-------------| | discord_login | Authenticate with Discord | | discord_get_server_info | Get server details, channels, members count | | discord_send | Send message to any channel |

Channel Management

| Tool | Description | |------|-------------| | discord_create_text_channel | Create text channel | | discord_create_voice_channel | Create voice channel with bitrate/user limit | | discord_edit_channel | Edit name, topic, category, position, NSFW, slowmode | | discord_delete_channel | Delete any channel | | discord_create_category | Create category | | discord_edit_category | Edit category | | discord_delete_category | Delete category |

Role Management

| Tool | Description | |------|-------------| | discord_list_roles | List all server roles | | discord_create_role | Create role with color, permissions, hoist, mentionable | | discord_edit_role | Modify role properties | | discord_delete_role | Remove role | | discord_assign_role | Give role to member | | discord_remove_role | Take role from member |

Permission Management

| Tool | Description | |------|-------------| | discord_set_channel_permissions | Set allow/deny permissions for role or member | | discord_get_channel_permissions | View current permission overwrites | | discord_remove_channel_permissions | Remove permission overwrites |

Member Management

| Tool | Description | |------|-------------| | discord_list_members | List all members (filter bots optional) | | discord_get_member | Get member details, roles, permissions |

Message Management

| Tool | Description | |------|-------------| | discord_read_messages | Read channel messages (limit configurable) | | discord_delete_message | Delete single message | | discord_bulk_delete_messages | Delete up to 100 messages at once | | discord_edit_message | Edit message content | | discord_pin_message | Pin message | | discord_unpin_message | Unpin message | | discord_move_messages | Move messages between channels |

Reactions

| Tool | Description | |------|-------------| | discord_add_reaction | Add emoji reaction | | discord_add_multiple_reactions | Add multiple reactions at once | | discord_remove_reaction | Remove reaction |

Forums

| Tool | Description | |------|-------------| | discord_get_forum_channels | List forum channels | | discord_create_forum_post | Create post with tags | | discord_get_forum_post | Get post with messages | | discord_reply_to_forum | Reply to post | | discord_delete_forum_post | Delete post |

Webhooks

| Tool | Description | |------|-------------| | discord_create_webhook | Create webhook | | discord_send_webhook_message | Send via webhook | | discord_edit_webhook | Edit webhook | | discord_delete_webhook | Delete webhook |

Batch Operations

| Tool | Description | |------|-------------| | discord_batch_operations | Execute multiple operations sequentially |

Permission Names

Available permission flags for discord_set_channel_permissions:

ViewChannel          SendMessages         ReadMessageHistory
ManageMessages       ManageChannels       ManageRoles
Connect              Speak                MuteMembers
DeafenMembers        MoveMembers          ManageWebhooks
AddReactions         AttachFiles          EmbedLinks
CreateInstantInvite  UseExternalEmojis    ManageThreads
SendMessagesInThreads

Examples

Hide category from @everyone

discord_set_channel_permissions({
  channelId: "CATEGORY_ID",
  targetId: "EVERYONE_ROLE_ID", // Same as Guild ID
  targetType: "role",
  deny: ["ViewChannel"]
})

Allow role to access category

discord_set_channel_permissions({
  channelId: "CATEGORY_ID",
  targetId: "ROLE_ID",
  targetType: "role",
  allow: ["ViewChannel", "SendMessages", "ReadMessageHistory"]
})

Create role with color

discord_create_role({
  guildId: "SERVER_ID",
  name: "Developer",
  color: "#3498DB",
  hoist: true,
  mentionable: true
})

Bulk delete messages

discord_bulk_delete_messages({
  channelId: "CHANNEL_ID",
  limit: 50
})

Dependencies

| Package | Version | Description | |---------|---------|-------------| | @modelcontextprotocol/sdk | ^1.25.1 | MCP SDK | | discord.js | ^14.25.1 | Discord API | | zod | ^4.2.1 | Schema validation | | express | ^5.2.1 | HTTP server | | dotenv | ^17.2.3 | Environment variables |

Credits

• Original: Barry Yip
• Extended by: Kogollones

License

MIT - Copyright (c) 2025 BarryY (Original), Kogollones (Extended)