GustyCube/discord-mcp

Discord MCP Server

A Model Context Protocol server that provides AI agents with secure access to Discord's REST API and Gateway events.

Features

🔧 120+ Discord API Tools - Complete coverage of Discord's REST API
🔒 Security First - Guild/channel allowlists, safe defaults, no accidental mentions
⚡ Real-time Events - Gateway integration for live Discord activity
🎯 Smart Routing - Auto-generated tools from declarative API catalog
📦 Modular Packs - Enable only the functionality you need

Quick Start

# Clone and install
git clone https://github.com/GustyCube/discord-mcp
cd discord-mcp
npm install

# Configure your bot
cp .env.example .env
# Add your DISCORD_BOT_TOKEN and other settings

# Build and run
npm run build
npm start

Documentation

📖 Complete documentation available at discord-mcp.gustycube.com

Quick Links

• Getting Started
• Configuration
• Available Tools
• Security Model
• Examples

Example: Claude Desktop Integration

Add to your mcp.json:

{
  "mcpServers": {
    "discord": {
      "command": "node",
      "args": ["/path/to/discord-mcp/dist/index.js"],
      "env": {
        "DISCORD_BOT_TOKEN": "your_bot_token_here",
        "ALLOW_GUILD_IDS": "123456789,987654321",
        "ALLOW_CHANNEL_IDS": "111111111,222222222"
      }
    }
  }
}

What You Can Do

• 📝 Message Management - Send, edit, delete messages and reactions
• 👥 User & Guild Info - Get user profiles, guild details, member lists
• 🔊 Channel Operations - List channels, manage permissions, create threads
• 🎭 Rich Content - Send embeds, manage webhooks, upload files
• ⚡ Live Events - Subscribe to message events, member joins, etc.
• 🛡️ Moderation - Manage bans, kicks, roles (with appropriate permissions)

Contributing

See the full documentation for development setup, API reference, and contribution guidelines.

License

MIT License - see file for details.