Discord MCP Server
Read messages, post to channels, and manage your Discord server from Claude Desktop
The Discord MCP server exposes your Discord guild to Claude and other MCP-compatible AI agents. Claude can read channel history, post messages, list server members, and fetch channel information — making it possible to build Discord bots, summarise server activity, or moderate conversations with AI assistance.
Prerequisites
- Node.js 18+ — required to run via
npx - Discord Bot Token — create a bot at discord.com/developers/applications
- Bot needs Message Content Intent enabled in the portal and the following permissions:
Read Messages,Send Messages,View Channel - Invite the bot to your server with the correct permission scopes
Installation & Configuration
Add this block to your claude_desktop_config.json:
{
"mcpServers": {
"discord": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-discord"],
"env": {
"DISCORD_TOKEN": "Bot YOUR_BOT_TOKEN_HERE"
}
}
}
}
Config file location:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/claude/claude_desktop_config.json
Available Tools (5)
list_guilds
List servers the bot is inlist_channels
List channels in a guildread_messages
Fetch message historysend_message
Post a message to a channelget_guild_members
List members in a server
Use Cases
- Summarise what was discussed in a channel while you were away
- Draft and post announcements or release notes to a channel
- Monitor a support channel and draft replies for human review
Tips & Gotchas
Gotcha: The
DISCORD_TOKEN env var must include the Bot prefix (with a space) — e.g. Bot MTkw.... Omitting it gives a 401 error.Gotcha: Message Content Intent must be toggled on in the Discord Developer Portal under your app's Bot settings. Without it,
read_messages returns empty content.Tip: Create a dedicated bot account just for MCP so you can easily revoke access without affecting other bots in your server.
Source & Documentation
GitHub Repository: https://github.com/modelcontextprotocol/servers/tree/main/src/discord
Discord Developer Portal: discord.com/developers/applications
Protocol: Model Context Protocol (MCP) — modelcontextprotocol.io
MCP Setup Pack — $15
20 ready-to-paste server configs + installer + doctor script
Get the Pack →
20 ready-to-paste server configs + installer + doctor script