discord-mcp

A MCP (Model Context Protocol) server that lets Claude control Discord: read/send messages, manage members, roles, channels, and permissions.

---

• Node.js >= 18
• A Discord Bot with its token
• Claude Desktop (or any MCP-compatible client)

---

cd discord-mcp

npm install

npm run build

---

1. Go to discord.com/developers/applications
2. New Application > give it a name
3. Bot tab > Reset Token > copy the token
4. Enable Privileged Gateway Intents:

• Server Members Intent
• Message Content Intent

1. OAuth2 > URL Generator:

• Scopes: bot
• Permissions: Send Messages, Read Message History, Manage Channels, Manage Roles, Kick Members, Ban Members, Moderate Members, View Audit Log, Manage Messages, Manage Threads, Add Reactions, Manage Guild

1. Copy the generated URL and invite the bot to your server

---

Add this to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "discord": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/discord-mcp/dist/index.js"],
      "env": {
        "DISCORD_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

Restart Claude Desktop after saving.

Instead of passing the token in the MCP config, you can create a .env file at the project root:

DISCORD_TOKEN=YOUR_TOKEN_HERE

The server loads .env automatically via dotenv.

---

| Tool | Description | |---|---| | discord_list_guilds | List all servers the bot is connected to | | discord_get_guild_info | Get detailed guild info (name, members, channels, roles, boosts) | | `di