Discord MCP
An MCP server providing 26 tools for Discord API interactions, enabling message management, moderation, channel operations, and server inspection through Claude Code, Paperclip agents, or other MCP-compatible clients.
What is Discord MCP?
Discord MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server providing 26 tools for discord api interactions, enabling message management, moderation, channel operations, and server inspection through claude code, paperclip agents, or other mcp-compa...
An MCP server providing 26 tools for Discord API interactions, enabling message management, moderation, channel operations, and server inspection through Claude Code, Paperclip agents, or other MCP-compatible clients.
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- An MCP server providing 26 tools for Discord API interaction
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @goul4rt/mcp-discordManual Installation
npx -y @goul4rt/mcp-discordConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Discord MCP
mcp-discord provides 26 MCP tools for comprehensive Discord API integration, enabling AI assistants to send and read messages, manage channels, handle roles, moderate servers, and inspect server metadata — all through natural language commands in Claude Desktop, Claude Code, or any MCP-compatible client. It covers everything from message history retrieval and reaction management to member timeouts and role assignments, making it practical for both Discord bot workflows and automated server administration.
Prerequisites
- Python 3.10+ and uv package manager installed
- A Discord bot token — create an application at https://discord.com/developers/applications, add a bot, and copy the token
- Discord bot intents enabled: MESSAGE CONTENT INTENT, PRESENCE INTENT, and SERVER MEMBERS INTENT (in the bot's settings on the developer portal)
- The bot must be invited to your Discord server using OAuth2 with appropriate permissions
- An MCP-compatible client such as Claude Desktop or Claude Code
Create a Discord bot and get a token
Go to https://discord.com/developers/applications, create a new application, navigate to the Bot section, enable the three required privileged intents (Message Content, Presence, Server Members), and copy the bot token.
Invite the bot to your server
In the OAuth2 > URL Generator section of your application, select 'bot' scope and the permissions your use case needs (Send Messages, Read Message History, Manage Channels, etc.). Open the generated URL to invite the bot.
Clone and install mcp-discord
Clone the repository and install dependencies using uv in a virtual environment.
git clone https://github.com/hanweg/mcp-discord.git
cd mcp-discord
uv venv
source .venv/bin/activate
uv pip install -e .Configure Claude Desktop with your Discord token
Add the server to claude_desktop_config.json, setting DISCORD_TOKEN to your bot token. Use absolute paths.
Restart Claude Desktop and test the connection
Restart Claude Desktop, then ask it to list your Discord servers or send a test message to a channel. The bot must be online and in the target server for this to work.
Discord MCP Examples
Client configuration
Claude Desktop configuration for mcp-discord. Replace paths and token with your actual values.
{
"mcpServers": {
"mcp-discord": {
"command": "uv",
"args": ["--directory", "/absolute/path/to/mcp-discord", "run", "main.py"],
"env": {
"DISCORD_TOKEN": "your-bot-token-here"
}
}
}
}Prompts to try
Example prompts after connecting mcp-discord to your AI assistant.
- "List all Discord servers the bot is in and their channel counts"
- "Send a message to #announcements in my server saying 'Deployment complete!'"
- "Get the last 20 messages from #general and summarize the discussion"
- "Add the 'moderator' role to user JohnDoe in my server"
- "Timeout user SpamBot for 10 minutes in the main server"Troubleshooting Discord MCP
Bot connects but cannot read message content
Enable the MESSAGE CONTENT INTENT in the Discord Developer Portal under your bot's settings. Without this, the bot receives messages but their content field is empty.
403 Missing Permissions error when sending messages or managing channels
Re-invite the bot using OAuth2 with the specific permissions required for the operations you need (Send Messages, Manage Channels, Manage Roles). Check the bot's role permissions in the Discord server settings.
Server list is empty even though the bot is in servers
Enable SERVER MEMBERS INTENT and PRESENCE INTENT in the Discord Developer Portal. Without these privileged intents, guild member and presence data is not returned.
Frequently Asked Questions about Discord MCP
What is Discord MCP?
Discord MCP is a Model Context Protocol (MCP) server that mcp server providing 26 tools for discord api interactions, enabling message management, moderation, channel operations, and server inspection through claude code, paperclip agents, or other mcp-compatible clients. 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 @goul4rt/mcp-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.