Overview
The Discord MCP Server is a server designed for integrating Model Context Protocol (MCP) capabilities with Discord, enabling enhanced interaction for MCP clients like Claude Desktop.
To use the Discord MCP Server, set up a Discord bot via the Discord Developer Portal, clone the repository, install the package, and configure it to work with Claude Desktop for efficient message and channel management.
- Server information retrieval - Message management (send, read, react, moderate) - Channel management (create and delete channels) - Role management (add and remove roles) - Webhook management (create, list, modify, and delete webhooks)
- Automating server management tasks for Discord communities.
- Enhancing bot functionality for real-time message handling.
- Using webhooks for delivering data from external sources into Discord channels.
Add to your AI client
Use these steps to connect Discord MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"mcp-discord-hanweg": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-discord-hanweg"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"mcp-discord-hanweg": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-discord-hanweg"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"mcp-discord-hanweg": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-discord-hanweg"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"mcp-discord-hanweg": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-discord-hanweg"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-discord-hanweg": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-discord-hanweg"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"mcp-discord-hanweg": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-discord-hanweg"
]
}
}
}FAQ
How do I set up the Discord bot?
Follow the steps outlined in the installation section to create a bot and integrate it with the MCP server.
What permissions does the bot need?
The bot requires privileged intents such as MESSAGE CONTENT INTENT, PRESENCE INTENT, and SERVER MEMBERS INTENT.
Is the MCP Server open-source?
Yes! The Discord MCP Server is available on GitHub under the MIT License.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":520,"uuid":"32d16df0-3f6d-4c76-9f6e-0d36fa14eb3b","name":"mcp-discord","title":"Discord MCP Server","description":"MCP server for discord bot","avatar_url":"https://avatars.githubusercontent.com/u/140543700?v=4","created_at":"2024-12-30T02:53:27.516Z","updated_at":"2025-01-05T03:00:15.057Z","status":"created","author_name":"hanweg","author_avatar_url":"https://avatars.githubusercontent.com/u/140543700?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/hanweg/mcp-discord","target":"_self","content":"$29","summary":"$2a","img_url":"https://camo.githubusercontent.com/a8f86350d0355ecbe222ed8719538d872b4e907fdbf21f13e40068c5bc5b38c7/68747470733a2f2f736d6974686572792e61692f62616467652f4068616e7765672f6d63702d646973636f7264","type":null,"metadata":"{\"star\":\"44\",\"license\":\"MIT license\",\"language\":\"Python\",\"is_official\":false,\"latest_commit_time\":\"2025-02-01 20:25:16\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]