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

Discord Extended