Discord MCP Extended

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 from the original mcp-discord and Codependent AI fork.

---

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

| Tool | Description | |------|-------------| | discord_send | Send a message (with optional reply) | | discord_read_messages | Read messages from a channel (up to 100) | | discord_delete_message | Delete a specific message | | discord_search_messages | Search messages with filters |

Voice

| Tool | Description | |------|-------------| | discord_send_voice | Send voice message via ElevenLabs TTS |

Images

| Tool | Description | |------|-------------| | discord_fetch_image | Fetch and auto-scale Discord images |

Reactions

| Tool | Description | |------|-------------| | discord_add_reaction | Add a single reaction | | discord_add_multiple_reactions | Add multiple reactions at once | | discord_remove_reaction | Remove a reaction |

Forums

| Tool | Description | |------|-------------| | discord_get_forum_channels | List forum channels in a server | | discord_create_forum_post | Create a new forum post | | discord_get_forum_post | Get forum post details | | discord_reply_to_forum | Reply to a forum thread | | discord_delete_forum_post | Delete a forum post |

Channels & Categories

| Tool | Description | |------|-------------| | discord_create_text_channel | Create a text channel | | discord_delete_channel | Delete a channel | | discord_create_category | Create a category | | discord_edit_category | Edit a category | | discord_delete_category | Delete a category |

Webhooks

| Tool | Description | |------|-------------| | discord_create_webhook | Create a webhook | | discord_send_webhook_message | Send via webhook | | discord_edit_webhook | Edit a webhook | | discord_delete_webhook | Delete a webhook |

Server Info

| Tool | Description | |------|-------------| | discord_list_servers | List all servers the bot is in | | discord_get_server_info | Get server details and channels | | discord_login | Log in with bot token |

---

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 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 — Step-by-step for non-coders
• INSTALL.md — Quick technical setup
• README-AI.md — AI companion integration patterns