Discord MCP — Claude Code MCP server: features and setup
Connect a Discord bot to an AI client so an agent can manage server settings and read conversations. Requires your own bot and Node.js 22.12 or later.
claude mcp add --env DISCORD_TOKEN=<DISCORD_TOKEN> --env DISCORD_EXPECTED_BOT_ID=<DISCORD_EXPECTED_BOT_ID> --env ALLOWED_GUILDS=<ALLOWED_GUILDS> --transport stdio mcp-server -- npx -y @discord-mcp/cliWhat Discord MCP does
The server gives an agent tools for Discord messages, channels, roles, moderation, and server setup. It includes 222 typed tools. To build a server from a description, the agent can prepare a plan for review, carry out the approved work, resume an interrupted run, and check the result against Discord.
You need Node.js 22.12 or later and a bot installed in a server you control. After setup, apply the generated configuration to your AI client yourself. Guided setup blocks changes by default, while direct serve permits ordinary writes. That difference matters before you connect a bot with access to a server.
What it helps with
- set up channels and roles on a Discord server
- audit roles and inspect member permissions
- gather channel and thread history with citations
- review a server-change plan and verify the result
Example prompts for the agent
- Draft a Discord server plan with channels and roles, then show me the plan before making changes.
- Audit member access and identify roles with permissions to review.
- Gather the discussion from this channel and its threads, with citations.
How to install Discord MCP
Platform CLI
claude mcp add --env DISCORD_TOKEN=<DISCORD_TOKEN> --env DISCORD_EXPECTED_BOT_ID=<DISCORD_EXPECTED_BOT_ID> --env ALLOWED_GUILDS=<ALLOWED_GUILDS> --transport stdio mcp-server -- npx -y @discord-mcp/cliReplace <…> with your own values
Platform CLI
codex mcp add mcp-server --env DISCORD_TOKEN=<DISCORD_TOKEN> --env DISCORD_EXPECTED_BOT_ID=<DISCORD_EXPECTED_BOT_ID> --env ALLOWED_GUILDS=<ALLOWED_GUILDS> -- npx -y @discord-mcp/cliReplace <…> with your own values
Config file
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@discord-mcp/cli"
],
"env": {
"DISCORD_TOKEN": "<DISCORD_TOKEN>",
"DISCORD_EXPECTED_BOT_ID": "<DISCORD_EXPECTED_BOT_ID>",
"ALLOWED_GUILDS": "<ALLOWED_GUILDS>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@discord-mcp/cli"
],
"env": {
"DISCORD_TOKEN": "<DISCORD_TOKEN>",
"DISCORD_EXPECTED_BOT_ID": "<DISCORD_EXPECTED_BOT_ID>",
"ALLOWED_GUILDS": "<ALLOWED_GUILDS>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e DISCORD_TOKEN=<DISCORD_TOKEN> -e DISCORD_EXPECTED_BOT_ID=<DISCORD_EXPECTED_BOT_ID> -e ALLOWED_GUILDS=<ALLOWED_GUILDS> mcp-server npx -y @discord-mcp/cliReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Discord MCP
How do I install Discord MCP in Claude Code?
Run claude mcp add discord-mcp -e DISCORD_TOKEN=<DISCORD_TOKEN> -- npx -y @discord-mcp/cli. Replace <DISCORD_TOKEN> with your Discord bot token.
What does Discord MCP do?
It connects a Discord bot to an AI client over MCP. An agent can use its tools to manage server settings, moderate activity, and read conversations.
What does Discord MCP need to run?
You need Node.js 22.12 or later and your own Discord bot installed in a server you control. Apply the generated configuration to your AI client after setup.
