Discord MCP

Discord MCP

An open-source Model Context Protocol (MCP) server for Discord. Connect Claude, Codex, Cursor, and other MCP-compatible AI clients to your own Discord bot. Manage messages, channels, roles, moderation, and server setup through 222 typed tools.

Watch an AI agent build a gaming community: channels, roles, onboarding, AutoMod, and final verification. Play the 87-second video · Download MP4.

You want to…	Discord MCP provides
Run a community	Messages, threads, forums, roles, events, polls, and onboarding
Moderate a server	Permission checks, role audits, bans, and AutoMod
Build a server from a prompt	A blueprint to preview and approve, resumable execution, and final Discord readback
Extend your bot	Slash commands, interactions, webhooks, and application emojis
Improve an existing server	Preview bounded edits, inspect member access, preserve IDs, resume, and restore selected configuration changes
Read a conversation with sources	Gather bounded channel/thread history and replies with Discord citations and explicit coverage
Run a background workflow	Start a durable sequence, inspect progress, cancel cooperatively, and resume after reviewing checkpoints

For a complete server build, Get a verified result: review the plan, approve it, then inspect Activity Evidence from the final readback.

Requires Node.js 22.12+ and your own Discord bot installed in a server you control. Works on Windows, macOS, and Linux.

npm install -g @discord-mcp/cli

Set the bot token in your terminal:

# macOS / Linux
export DISCORD_TOKEN="Bot YOUR_DISCORD_BOT_TOKEN"

# Windows PowerShell
$env:DISCORD_TOKEN = "Bot YOUR_DISCORD_BOT_TOKEN"

Generate a client configuration and verify the connection (Codex example):

discord-mcp setup --profile devbot --client codex
discord-mcp doctor --profile devbot --online
discord-mcp smoke --profile devbot

setup verifies your bot, selects a server boundary, and saves a non-secret profile. Apply the generated configuration to your AI client; setup does not edit it for you. Launch the client with DISCORD_TOKEN available in its environment. The smoke check above does not change Discord.

See client setup for Claude, Codex, Cursor, VS Code/GitHub Copilot, Windsurf, Cline, Roo Code, Continue, Zed, OpenCode, Devin Local, and other clients, plus desktop-app token setup. New to MCP? Get started with the complete tutorial.