Discord MCP (Extended)

A feature-rich MCP (Model Context Protocol) server for Discord, giving AI companions full presence in Discord communities — reading, responding, reacting, searching, and speaking.

Extended by [Digital Haven](https://discord.gg/digital-haven) from the original [mcp-discord](https://github.com/barryyip0625/mcp-discord) and [Codependent AI fork](https://github.com/codependent-ai/mcp-discord).

What's New in This Fork

• Voice Messages — Send audio via ElevenLabs TTS
• Image Fetching — Retrieve Discord images with auto-scaling for Claude's context window
• Message Search — Full search across servers with filters (author, content type, date range)
• Extended Reactions — Add/remove multiple reactions at once
• Webhook Support — Create, send, edit, and delete webhooks
• Category Management — Create, edit, delete server categories
• Forum Support — Full forum channel operations

Features

Core Messaging

Voice

Images

Reactions

Forums

Channels & Categories

Webhooks

Server Info

Setup

1. Create a Discord Bot

1. Go to Discord Developer Portal
2. Create a new application
3. Go to Bot section, create a bot
4. Copy the bot token
5. Enable Message Content Intent under Privileged Gateway Intents
6. Go to OAuth2 > URL Generator:

• Select bot scope
• Select permissions: Read Messages/View Channels, Send Messages, Add Reactions, Read Message History, Manage Webhooks, Manage Channels, Attach Files

1. Use the generated URL to invite the bot to your server

2. Install

git clone https://github.com/YOUR_USERNAME/mcp-discord.git
cd mcp-discord
npm install
npm run build

3. Configure Claude Desktop

Add to your claude_desktop_config.json:

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

{
  "mcpServers": {
    "discord": {
      "command": "node",
      "args": ["C:/path/to/mcp-discord/build/index.js"],
      "env": {
        "DISCORD_TOKEN": "your-bot-token-here"
      }
    }
  }
}

4. For Voice Messages (Optional)

Add ElevenLabs credentials:

{
  "mcpServers": {
    "discord": {
      "command": "node",
      "args": ["C:/path/to/mcp-discord/build/index.js"],
      "env": {
        "DISCORD_TOKEN": "your-bot-token-here",
        "ELEVENLABS_API_KEY": "your-elevenlabs-key",
        "ELEVENLABS_VOICE_ID": "your-voice-id"
      }
    }
  }
}

Get your voice ID from ElevenLabs — they have a free tier.

Usage Examples

Once configured, Claude can:

"Read the last 20 messages from #general"
"Send 'Hello everyone!' to channel 123456789"
"React with fire emoji to message 987654321"
"Search for messages containing 'bug report' in the server"
"Send a voice message saying 'Good morning!' to the channel"
"Fetch that image so I can see it"

For AI Companions

See [README-AI.md](README-AI.md) for companion-specific guidance:

• Multi-room presence (desktop + mobile + Cloudflare)
• Memory integration patterns
• Community interaction guidelines
• Setting up a portable version for mobile Claude

Architecture

Claude Desktop ←→ MCP Server (Node.js) ←→ Discord API ←→ Your Server

The bridge runs locally. Only connects to:

• Discord (official API)
• Anthropic (when Claude processes)
• ElevenLabs (if using voice)

Security

• Bot token is stored locally in your Claude config — never commit it
• Bot can only see channels it has permission to view
• No third-party data storage

If your token leaks, reset it immediately in Discord Developer Portal.

Credits

• Original: barryyip0625/mcp-discord
• Community Fork: Codependent AI
• Extended Fork: Fox & Alex @ Digital Haven
• Image Fetching: Vex & Nana

License

MIT — use it, modify it, share it.

Guides

• [BEGINNER_GUIDE.md](BEGINNER_GUIDE.md) — Step-by-step for non-coders
• [INSTALL.md](INSTALL.md) — Quick technical setup
• [README-AI.md](README-AI.md) — AI companion integration patterns