Discord MCP
📇 🏠 🍎 🪟 🐧 - Lightweight multi-guild Discord MCP server with 60+ tools for messages, channels, rol
What is Discord MCP?
Discord MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 📇 🏠 🍎 🪟 🐧 - lightweight multi-guild discord mcp server with 60+ tools for messages, channels, rol
📇 🏠 🍎 🪟 🐧 - Lightweight multi-guild Discord MCP server with 60+ tools for messages, channels, rol
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- discord_send_message
- discord_edit_message
- discord_delete_message
- discord_add_reaction
- discord_remove_reaction
Use Cases
Maintainer
Works with
Installation
NPM
npx -y discordManual Installation
npx -y discordConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Discord MCP
Discord MCP is a lightweight multi-guild Discord integration that exposes over 60 tools for managing messages, channels, roles, webhooks, voice channels, moderation, and server events through the Model Context Protocol. Built as a Spring Boot Java application, it connects to the Discord API using a bot token and surfaces comprehensive guild management capabilities to any MCP-compatible AI client. Developers and community managers use it to automate Discord workflows, send notifications, moderate servers, and orchestrate multi-guild operations directly from their AI assistant.
Prerequisites
- Docker Desktop installed (recommended deployment method) or a JVM runtime for manual setup
- A Discord bot token — create a bot at https://discord.com/developers/applications and copy its token
- The bot must be invited to your Discord server(s) with appropriate permissions (Send Messages, Manage Channels, Manage Roles, etc.)
- An MCP-compatible client such as Claude Desktop, Cursor, or n8n
- The bot's Guild ID (Server ID) for default server targeting (optional but recommended)
Create a Discord bot and obtain a token
Navigate to https://discord.com/developers/applications, create a new application, add a Bot, and copy the token. Under OAuth2 scopes, select 'bot' and grant the permissions your use case requires. Use the generated URL to invite the bot to your server.
Start the server with Docker
Run the official Docker image, passing your Discord bot token and optionally your guild ID. The server will start on port 8085 and expose the MCP endpoint at /mcp.
docker run -d -i --name discord-mcp --restart unless-stopped \
-p 8085:8085 \
-e SPRING_PROFILES_ACTIVE=http \
-e DISCORD_TOKEN=your_bot_token_here \
-e DISCORD_GUILD_ID=your_guild_id_here \
saseq/discord-mcp:latestVerify the server is running
Check that the MCP endpoint is accessible by making a simple HTTP request to the server.
curl http://localhost:8085/mcpAdd the server to your MCP client
For Claude Desktop, add the discord-mcp entry to your claude_desktop_config.json. The server uses HTTP transport, so no command/args are needed — just the URL.
{
"mcpServers": {
"discord-mcp": {
"url": "http://localhost:8085/mcp"
}
}
}Add via Claude Code CLI (alternative)
If you use Claude Code, register the server with a single command instead of editing config files manually.
claude mcp add discord-mcp --transport http http://localhost:8085/mcpTest by sending a message
With the server registered, ask your AI assistant to send a test message to a Discord channel. The assistant will invoke the send_message tool with the channel ID and content.
Discord MCP Examples
Client configuration
Claude Desktop HTTP configuration for the Discord MCP server running locally.
{
"mcpServers": {
"discord-mcp": {
"url": "http://localhost:8085/mcp"
}
}
}Prompts to try
Example prompts for Discord automation tasks once the server is connected.
- "Send a message to channel #announcements saying 'Deployment complete!'"
- "List all channels in my Discord server"
- "Create a new role called 'Beta Tester' with a blue color"
- "Kick the user named 'spammer123' from the server"
- "Create a webhook for channel #alerts and send a test message through it"
- "List all members who have been banned from the server"Troubleshooting Discord MCP
Bot actions fail with '403 Missing Permissions'
The bot's role in your Discord server must have the required permissions for each action. Go to Server Settings > Roles, find the bot's role, and enable permissions like Manage Channels, Manage Roles, Kick Members, or Ban Members as needed. The bot role must also be ranked higher than the roles it manages.
Docker container starts but MCP endpoint returns 404
Ensure SPRING_PROFILES_ACTIVE is set to 'http' in the Docker run command. Without this environment variable the HTTP transport is not activated and the /mcp endpoint will not exist.
DISCORD_TOKEN environment variable is rejected
Make sure you are using the bot token, not the client secret or application ID. In the Discord Developer Portal go to your application > Bot > Reset Token to generate a fresh token. Tokens are single-use and cannot be recovered after initial display.
Frequently Asked Questions about Discord MCP
What is Discord MCP?
Discord MCP is a Model Context Protocol (MCP) server that 📇 🏠 🍎 🪟 🐧 - lightweight multi-guild discord mcp server with 60+ tools for messages, channels, rol It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Discord MCP?
Install via npm with the command: npx -y discord. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Discord MCP?
Discord MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Discord MCP free to use?
Yes, Discord MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Discord MCP Alternatives — Similar Communication Servers
Looking for alternatives to Discord MCP? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Discord MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Discord MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.