Discord MCP Server (barryyip0625)
Discord MCP for messaging, channel/forum management, reactions and webhooks
Add to your client
Copy the config for your MCP client and paste it into its config file.
npx -y mcp-discord --config <your-discord-bot-token>Paste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"discord-mcp-server-barryyip0625": {
"command": "npx",
"args": [
"-y",
"mcp-discord",
"--config",
"<your-discord-bot-token>"
],
"env": {
"DISCORD_TOKEN": "<your-discord-bot-token>"
}
}
}
}Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf
Before you start
- Node.js v18.0.0 or higher and npm v7.0.0 or higher (or Docker for containerized deployment)
- A Discord application with a bot, created in the Discord Developer Portal, and its bot token
- The Message Content, Server Members, and Presence privileged intents enabled for the bot
- The bot invited to your target server via an OAuth2 invite link with appropriate permissions (Administrator recommended, or granular Send Messages / Manage Channels / Manage Roles / Manage Messages / Add Reactions / View Channels)
About Discord MCP Server (barryyip0625)
Discord MCP Server (barryyip0625) is a feature-rich Model Context Protocol server that gives AI assistants broad control over a Discord server through a bot. It covers messaging, full channel and category management, forum operations, reactions, webhooks, role management, and member lookups.
The server is written in TypeScript and supports two transports: stdio (the default, for local MCP clients) and a streamable HTTP transport on a configurable port. It can be installed via npx, built from source, or run as a Docker container (barryy625/mcp-discord).
Authentication uses a single Discord bot token. Because the toolset is wide-ranging — creating and deleting channels, managing roles, and editing messages — the bot typically needs broad permissions (Administrator is recommended for full functionality) and the Message Content, Server Members, and Presence privileged intents enabled in the Discord Developer Portal.
Tools & capabilities (15)
discord_loginAuthenticate the bot with Discord using the configured token
discord_list_serversList the servers (guilds) the bot is a member of
discord_get_server_infoGet details about a server
discord_sendSend a message to a text channel
discord_read_messagesRead recent messages from a channel
discord_edit_message / discord_delete_messageEdit or delete an existing message
discord_create_text_channel / discord_create_voice_channel / discord_create_forum_channelCreate text, voice, or forum channels
discord_edit_channel / discord_delete_channelEdit or delete a channel
discord_create_category / discord_edit_category / discord_delete_categoryManage channel categories
discord_set_channel_permissions / discord_remove_channel_permissionsSet or remove channel permission overwrites
discord_create_forum_post / discord_reply_to_forum / discord_update_forum_post / discord_delete_forum_postCreate, reply to, update, and delete forum posts/threads
discord_add_reaction / discord_add_multiple_reactions / discord_remove_reactionAdd one or many emoji reactions, or remove a reaction
discord_create_webhook / discord_edit_webhook / discord_delete_webhook / discord_send_webhook_messageCreate, edit, delete, and post messages via webhooks
discord_create_role / discord_edit_role / discord_delete_role / discord_assign_role / discord_remove_role / discord_list_rolesFull role lifecycle and assignment management
discord_list_members / discord_get_memberList server members or fetch a single member
When to use it
- Let an assistant post and read messages, or run a moderation/announcement bot across channels
- Automate server setup — create categories, text/voice/forum channels, and set permission overwrites
- Manage community forums: open posts with tags, reply, update, and clean up threads programmatically
- Run role-based automation, assigning or removing roles for members on demand
- Send richly formatted notifications through webhooks with custom names and avatars
- Apply reactions in bulk for polls or status tracking
Quick setup
- 1Create an application and bot in the Discord Developer Portal and copy the bot token
- 2Enable the Message Content, Server Members, and Presence privileged intents
- 3Invite the bot to your server with the needed permissions (Administrator for full coverage)
- 4Run the server via `npx mcp-discord --config <DISCORD_TOKEN>`, from source, or the barryy625/mcp-discord Docker image
- 5Add it to your MCP client config (stdio by default, or HTTP with --transport http --port 3000)
- 6Restart the client and verify with discord_login followed by discord_list_servers
Security notes
The Discord bot token grants full control of the bot account; restrict the bot's server permissions/intents to the minimum and never commit the token. Passing it via --config can leak into process listings, so prefer the DISCORD_TOKEN env var.
Discord MCP Server (barryyip0625) FAQ
Which intents and permissions does the bot need?
Enable the Message Content, Server Members, and Presence privileged intents. For full functionality the Administrator permission is recommended; otherwise grant the specific permissions for the tools you use (Send/Manage Messages, Manage Channels, Manage Roles, Add Reactions, View Channels).
How do I pass the bot token?
Provide it via the DISCORD_TOKEN environment variable, or pass it on the command line with `npx mcp-discord --config <token>`.
Does it support HTTP transport or only stdio?
Both. Stdio is the default for local MCP clients; you can also run an HTTP server with `--transport http --port 3000` (via build/app.js).
Is there a Docker image?
Yes. Pull `barryy625/mcp-discord:latest` and run it in a container, passing the Discord token via environment configuration.
Why do messaging tools return nothing or fail?
Most commonly the Message Content intent is disabled, the bot lacks permission in the target channel, or it was never invited to the server. Verify intents in the Developer Portal and the bot's channel permissions.
Alternatives to Discord MCP Server (barryyip0625)
Compare all alternatives →
Connect your personal WhatsApp: search, read and send messages and media locally
Powerful Slack MCP with stdio/SSE/HTTP, DMs, group DMs and no-admin token auth
Full Telegram user-account MCP via MTProto: read chats, manage groups, send messages
Compare Discord MCP Server (barryyip0625) with: