MCP-Discord
Enables AI assistants to interact with Discord, including managing servers, channels, and forum posts; sending and reading messages; adding reactions; and creating and using webhooks.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP-Discord send a welcome message to the #general channel"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP-Discord
A Discord MCP (Model Context Protocol) server that enables AI assistants to interact with the Discord platform.
Overview
MCP-Discord provides the following Discord-related functionalities:
Login to Discord bot
Get server information
Read/delete channel messages
Send messages to specified channels (using either channel IDs or channel names)
Retrieve forum channel lists
Create/delete/reply to forum posts
Create/delete text channels
Add/remove message reactions
Create/edit/delete/use webhooks
Related MCP server: MCP-Discord
Table of Contents
Prerequisites
Node.js (v16.0.0 or higher)
npm (v7.0.0 or higher)
A Discord bot with appropriate permissions
Bot token (obtainable from the Discord Developer Portal)
Message Content Intent enabled
Server Members Intent enabled
Presence Intent enabled
Permissions required in your Discord server:
Easiest Setup
Administrator (Recommended for quick setup and full functionality)
Or, select only the required permissions:
Send Messages
Create Public Threads
Send Messages in Threads
Manage Messages
Manage Threads
Manage Channels
Manage Webhooks
Add Reactions
View Channel
Add your Discord bot to your server
To add your Discord bot to your server, use one of the following invite links (replace
INSERT_CLIENT_ID_HEREwith your bot's client ID):Administrator (full access): https://discord.com/oauth2/authorize?client_id=INSERT_CLIENT_ID_HERE&scope=bot&permissions=8
Custom permissions (minimum required): https://discord.com/oauth2/authorize?client_id=INSERT_CLIENT_ID_HERE&scope=bot&permissions=52076489808
Note:
According to Discord's security model, a bot can only access information from servers it has been explicitly added to.
If you want to use this MCP server to access a specific Discord server, you must add the bot to that server first.
Use the invite link below to add the bot to your target server.
Installation
Installing via Smithery
To install mcp-discord automatically via Smithery
Manual Installation
# Clone the repository
git clone https://github.com/barryyip0625/mcp-discord.git
cd mcp-discord
# Install dependencies
npm install
# Compile TypeScript
npm run buildConfiguration
A Discord bot token is required for proper operation. The server supports two transport methods: stdio and streamable HTTP.
Transport Methods
stdio (Default)
Traditional stdio transport for basic usage
Suitable for simple integrations
streamable HTTP
HTTP-based transport for more advanced scenarios
Supports stateless operation
Configurable port number
Configuration Options
You can provide configuration in two ways:
Environment variables:
DISCORD_TOKEN=your_discord_bot_tokenUsing command line arguments:
# For stdio transport (default)
node build/index.js --config "your_discord_bot_token"
# For streamable HTTP transport
node build/index.js --transport http --port 3000 --config "your_discord_bot_token"Usage with Claude/Cursor
Claude
Using stdio transport:
{
"mcpServers": {
"discord": {
"command": "node",
"args": [
"path/to/mcp-discord/build/index.js",
"--config",
"your_discord_bot_token"
]
}
}
}Using streamable HTTP transport:
{
"mcpServers": {
"discord": {
"command": "node",
"args": [
"path/to/mcp-discord/build/index.js",
"--transport",
"http",
"--port",
"3000",
"--config",
"your_discord_bot_token"
]
}
}
}Cursor
Using stdio transport:
{
"mcpServers": {
"discord": {
"command": "cmd",
"args": [
"/c",
"node",
"path/to/mcp-discord/build/index.js",
"--config",
"your_discord_bot_token"
]
}
}
}Using streamable HTTP transport:
{
"mcpServers": {
"discord": {
"command": "cmd",
"args": [
"/c",
"node",
"path/to/mcp-discord/build/index.js",
"--transport",
"http",
"--port",
"3000",
"--config",
"your_discord_bot_token"
]
}
}
}Tools Documentation
Basic Functions
discord_login: Login to Discorddiscord_send: Send a message to a specified channel (supports both channel ID and channel name)discord_get_server_info: Get Discord server information
Channel Management
discord_create_text_channel: Create a text channeldiscord_delete_channel: Delete a channel
Forum Functions
discord_get_forum_channels: Get a list of forum channelsdiscord_create_forum_post: Create a forum postdiscord_get_forum_post: Get a forum postdiscord_reply_to_forum: Reply to a forum postdiscord_delete_forum_post: Delete a forum post
Messages and Reactions
discord_read_messages: Read channel messagesdiscord_add_reaction: Add a reaction to a messagediscord_add_multiple_reactions: Add multiple reactions to a messagediscord_remove_reaction: Remove a reaction from a messagediscord_delete_message: Delete a specific message from a channel
Webhook Management
discord_create_webhook: Creates a new webhook for a Discord channeldiscord_send_webhook_message: Sends a message to a Discord channel using a webhookdiscord_edit_webhook: Edits an existing webhook for a Discord channeldiscord_delete_webhook: Deletes an existing webhook for a Discord channel
Development
# Development mode
npm run devLicense
Available Tools
22 toolsdiscord_add_multiple_reactionsB
Adds multiple emoji reactions to a Discord message at once
Inputs: channelId (required), messageId (required), emojis (required).
discord_add_reactionC
Adds an emoji reaction to a specific Discord message
Inputs: channelId (required), messageId (required), emoji (required).
discord_create_categoryC
Creates a new category in a Discord server.
Inputs: guildId (required), name (required), position, reason.
discord_create_forum_postB
Creates a new post in a Discord forum channel with optional tags
Inputs: forumChannelId (required), title (required), content (required), tags.
discord_create_text_channelB
Creates a new text channel in a Discord server with an optional topic
Inputs: guildId (required), channelName (required), topic.
discord_create_webhookC
Creates a new webhook for a Discord channel
Inputs: channelId (required), name (required), avatar, reason.
discord_delete_categoryB
Deletes a Discord category by ID.
Inputs: categoryId (required), reason.
discord_delete_channelB
Deletes a Discord channel with an optional reason
Inputs: channelId (required), reason.
discord_delete_forum_postC
Deletes a forum post or thread with an optional reason
Inputs: threadId (required), reason.
discord_delete_messageB
Deletes a specific message from a Discord text channel
Inputs: channelId (required), messageId (required), reason.
discord_delete_webhookC
Deletes an existing webhook for a Discord channel
Inputs: webhookId (required), webhookToken, reason.
discord_edit_categoryB
Edits an existing Discord category (name and position).
Inputs: categoryId (required), name, position, reason.
discord_edit_webhookC
Edits an existing webhook for a Discord channel
Inputs: webhookId (required), webhookToken, name, avatar, +2 more.
discord_get_forum_channelsA
Lists all forum channels in a specified Discord server (guild)
Inputs: guildId (required).
discord_get_forum_postB
Retrieves details about a forum post including its messages
Inputs: threadId (required).
discord_get_server_infoB
Retrieves detailed information about a Discord server including channels and member count
Inputs: guildId (required).
discord_loginB
Logs in to Discord using the configured token
Inputs: token.
discord_read_messagesA
Retrieves messages from a Discord text channel with a configurable limit
Inputs: channelId (required), limit.
discord_remove_reactionB
Removes a specific emoji reaction from a Discord message
Inputs: channelId (required), messageId (required), emoji (required), userId.
discord_reply_to_forumB
Adds a reply to an existing forum post or thread
Inputs: threadId (required), message (required).
discord_sendC
Sends a message to a specified Discord text channel
Inputs: channelId (required), message (required).
discord_send_webhook_messageB
Sends a message to a Discord channel using a webhook
Inputs: webhookId (required), webhookToken (required), content (required), username, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 22 tools
Every tool has a clearly distinct purpose targeting specific Discord resources and actions, such as discord_add_reaction vs discord_remove_reaction for reactions, discord_create_text_channel vs discord_delete_channel for channels, and discord_send vs discord_send_webhook_message for messaging. There is no overlap or ambiguity in functionality, making tool selection straightforward for an agent.
All tool names follow a consistent snake_case pattern with a 'discord_' prefix and a clear verb_noun structure, such as discord_create_category, discord_delete_message, and discord_get_server_info. This uniformity enhances readability and predictability across the entire tool set.
With 22 tools, the count is borderline high for a Discord server, as it covers many specific operations like reactions, channels, webhooks, and forum posts. While comprehensive, it may feel heavy compared to more focused servers, but it aligns reasonably with Discord's broad API scope.
The tool set provides extensive coverage of Discord's core features, including CRUD operations for channels, categories, webhooks, messages, reactions, and forum posts. Minor gaps exist, such as missing tools for editing messages or managing server roles, but agents can handle most workflows effectively with the available tools.
Maintenance
Related MCP Connectors
Control your Discord community: send/read messages, manage channels and forums, and handle webhook…
The AI admin for Discord: manage channels, roles, members, moderation and automations.
Build Discord communities with AI: roles, channels, modules, automations and reviewed announcements.
Connect a Discord bot (bot token from the developer portal) to read/send messages, list guilds and c
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to interact with Discord through a bot, supporting server and member inspection, channel and role management, message and reaction handling, forum operations, and webhook administration.1,578 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to interact with the Discord platform by managing servers, channels, roles, forum posts, messages, reactions, and webhooks through a Discord bot.1,578 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to operate a Discord bot and manage Discord servers, channels, forums, messages, reactions, webhooks, roles, and members.1,578 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to interact with Discord by managing servers, channels, roles, members, messages, forum posts, reactions, and webhooks through a Discord bot.1,578 npmMIT