Discord MCP
MCP server for Discord: an agent manages channels, roles, messages and moderation through your server bot token
- 603 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Sends, edits and deletes messages in channels and DMs
- Kicks, bans and times out server members
- Creates and deletes channels, roles and permissions via a bot token
Install
- Works in
Manual install
docker run -d -i --name discord-mcp --restart unless-stopped -p 8085:8085 -e SPRING_PROFILES_ACTIVE=http -e DISCORD_TOKEN -e DISCORD_GUILD_ID saseq/discord-mcp:latestSet DISCORD_TOKEN in the environment before running. Endpoint: http://localhost:8085/mcp.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Sends, edits and deletes messages in channels and DMs
- Kicks, bans and times out server members
- Creates and deletes channels, roles and permissions via a bot token
This is third-party code. Review the repository files before installing.
What it does
This Java and JDA server gives an agent broad access to Discord through a bot. It reads and writes messages in channels and DMs, adds reactions, and creates and edits text, voice and forum channels, categories and webhooks. It manages roles and permissions, handles moderation with kick, ban and timeout, schedules events, and works with invites and emojis. It runs in http mode as one shared container or in stdio mode.
Who it is for. For Discord server owners, moderators and community managers who automate server management.
Good fit when
- You want an agent to send and read messages in Discord channels
- You want to automate creating channels, roles and events
- You need moderation and permission management through a bot
Not a fit when
- You have no Discord bot with a token and the needed server permissions
- You cannot install Docker, Java or Maven to run the server
Example request
Create an announcements channel, let the moderator role post in it and pin a welcome messageMCP
- Transport
- http, stdio
- Authentication
- API key
Environment variables
DISCORD_TOKENrequired, secret- Discord bot token with the needed server permissions
DISCORD_GUILD_ID- Default server id so guildId can be omitted in each call
SPRING_PROFILES_ACTIVE- Run mode: http for a shared container or stdio
Limitations
You need a Discord bot with its own token and server permissions; some operations require matching bot roles. Access to Discord is restricted in Russia, so without workarounds the server and API may be unreachable. It runs from a Docker image, Docker Compose or a Maven-built jar; there is no ready npm or PyPI package. If DISCORD_GUILD_ID is set, the guildId parameter becomes optional in the tools.
How to disable. Stop and remove the discord-mcp container or delete the block from your MCP client config and restart it.
FAQ
How do http and stdio modes differ?
In http mode one shared container is started and clients connect at the /mcp endpoint. In stdio mode a separate process or container is launched per client session.
Do I need DISCORD_GUILD_ID?
It is optional. If you set a default server id, tools that accept guildId can be called without it.
Discussion
No questions or reviews yet.
Related
MCP serversDiscord MCP by cappyeo: a server with 200+ tools
Discord MCP (cappyeo)
A Discord MCP with over 200 typed tools: the agent handles messages, roles and moderation, builds a server from a plan, and writes default to preview mode
A Discord MCP for Claude and Cursor: the agent posts and searches messages and manages forums, channels, roles and webhooks through a bot token
An MCP server for Minecraft: an agent controls a bot character via Mineflayer to build and explore
A Node.js MCP server through which an agent controls Home Assistant devices and edits its automations
MCP server for Home Assistant: an agent reads device states, controls them and edits smart home dashboards
The Kite MCP builds and fixes Discord bots from a chat: commands, event listeners, message templates and flow testing.
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Discord MCP (this card) | no | API key | 603 | |
| kubectl-mcp-server | no | not required | 972 | reads cluster state and diagnoses pod failures |
| Unreal Engine MCP Server | no | not required | 1,033 | Unreal Engine assets, actors and blueprints |
| Android MCP | no | not required | 924 | controls an Android device through ADB |
README in short
The README covers Docker as the main install path, plus Docker Compose and a manual Maven jar build. It shows connections for Claude Code, Codex CLI, Cursor, Claude Desktop and n8n, the http and stdio modes, and the endpoint at http://localhost:8085/mcp. The tool list spans server, users, messages, channels, categories, webhooks, roles, moderation, voice channels, events, permissions, invites, forums and emojis. DISCORD_TOKEN is required and DISCORD_GUILD_ID is optional. MIT licensed.