MCP-Discord
@barryyip0625
About MCP-Discord
Implement Discord MCP server enabling AI assistants to interact with the Discord platform.
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"mcp-discord-barryyip0625": {
"command": "npx",
"args": [
"mcp-discord",
"--config",
"${DISCORD_TOKEN}"
]
}
}
}Tools
22Creates a new category in a Discord server.
Edits an existing Discord category (name and position).
Deletes a Discord category by ID.
Logs in to Discord using the configured token
Sends a message to a specified Discord text channel
Lists all forum channels in a specified Discord server (guild)
Creates a new post in a Discord forum channel with optional tags
Retrieves details about a forum post including its messages
Adds a reply to an existing forum post or thread
Creates a new text channel in a Discord server with an optional topic
Deletes a Discord channel with an optional reason
Retrieves messages from a Discord text channel with a configurable limit
Retrieves detailed information about a Discord server including channels and member count
Adds an emoji reaction to a specific Discord message
Adds multiple emoji reactions to a Discord message at once
Removes a specific emoji reaction from a Discord message
Deletes a forum post or thread with an optional reason
Deletes a specific message from a Discord text channel
Creates a new webhook for a Discord channel
Sends a message to a Discord channel using a webhook
Edits an existing webhook for a Discord channel
Deletes an existing webhook for a Discord channel
Overview
What is MCP-Discord?
MCP-Discord is a Discord Model Context Protocol (MCP) server that enables AI assistants to interact with Discord platform. It provides tools for managing servers, channels, messages, roles, members, forum posts, reactions, and webhooks.
How to use MCP-Discord?
Run with npx mcp-discord --config ${DISCORD_TOKEN} or via Docker (e.g., docker run -e DISCORD_TOKEN=your_token ...). Configure the bot token as an environment variable or command-line argument. Requires Node.js v18+ and a Discord bot with appropriate permissions (Administrator recommended). Add the bot to target servers first.
Key features of MCP-Discord
- Login to Discord bot and list servers
- Manage channels: create, edit, delete text/forum/voice/categories
- Manage forum posts: create, update, delete, reply, manage tags
- Send, read, edit, delete messages; search messages
- Manage roles: create, edit, delete, assign, remove
- Manage webhooks: create, edit, delete, send messages via webhook
- Add/remove reactions and manage member details
Use cases of MCP-Discord
- Automate server moderation and channel management with AI
- Let AI assistants send messages and manage forum threads
- Programmatically assign roles and manage permissions
- Search and retrieve message history across servers
- Create and manage webhooks for external integrations
FAQ from MCP-Discord
What dependencies or runtime are required?
Node.js v18.0.0 or higher and npm v7.0.0 or higher are required.
What Discord bot permissions are needed?
Administrator permissions are recommended for full functionality. Alternatively, enable Send Messages, Create Public Threads, Manage Messages, Manage Threads, Manage Channels, Manage Webhooks, Manage Roles, Add Reactions, View Channel, Message Content Intent, Server Members Intent, and Presence Intent.
Can MCP-Discord access any Discord server?
No. The bot can only access servers it has been explicitly added to via an invite link.
What transport methods does MCP-Discord support?
It supports stdio (default) and streamable HTTP transport. The HTTP server can be hosted with a configurable port and provides an endpoint at /mcp.
Is MCP-Discord available as a Docker image?
Yes. Docker images are published on Docker Hub as barryy625/mcp-discord. Tags include latest and version-specific tags like v1.3.8.
Frequently asked questions
What dependencies or runtime are required?
Node.js v18.0.0 or higher and npm v7.0.0 or higher are required.
What Discord bot permissions are needed?
Administrator permissions are recommended for full functionality. Alternatively, enable Send Messages, Create Public Threads, Manage Messages, Manage Threads, Manage Channels, Manage Webhooks, Manage Roles, Add Reactions, View Channel, Message Content Intent, Server Members Intent, and Presence Intent.
Can MCP-Discord access any Discord server?
No. The bot can only access servers it has been explicitly added to via an invite link.
What transport methods does MCP-Discord support?
It supports stdio (default) and streamable HTTP transport. The HTTP server can be hosted with a configurable port and provides an endpoint at `/mcp`.
Is MCP-Discord available as a Docker image?
Yes. Docker images are published on Docker Hub as `barryy625/mcp-discord`. Tags include `latest` and version-specific tags like `v1.3.8`.
Basic information
More Communication MCP servers
Discord Mcp
SaseQA MCP server for the Discord integration. Enable your AI assistants to seamlessly interact with Discord. Enhance your Discord experience with powerful automation capabilities.
MailStream
Sponge LabsThe first MCP server for physical mail. Give any MCP-compatible AI agent the ability to send real postcards and letters, verify addresses, manage mailing lists and artwork, and track direct mail campaigns. Remote Streama
WhatsApp MCP Server (TypeScript/Baileys)
jlucaso1WhatsApp MCP Server (TypeScript/Baileys)
Mektup-mcp
WeeCiMektup gives AI agents and their humans a real email mailbox, not just a one-way sending API. Through 41 MCP tools, an agent can register a domain, create a mailbox, send and receive mail, and manage threads, drafts, fol
MCP Teams Server
InditexTechAn MCP (Model Context Protocol) server implementation for Microsoft Teams integration, providing capabilities to read messages, create messages, reply to messages, mention members.
Comments