@striderlabs/mcp-discord

An MCP (Model Context Protocol) server for Discord, enabling AI assistants like Claude to interact with Discord servers and channels via the Discord API.

Prerequisites

You need a Discord Bot Token. This connector uses the Discord.js library to communicate with Discord's official API — not browser automation.

Creating a Discord Bot

1. Go to the Discord Developer Portal
2. Click New Application and give it a name
3. Go to the Bot section and click Add Bot
4. Under Token, click Reset Token and copy the token
5. Under Privileged Gateway Intents, enable:
   • Server Members Intent
   • Message Content Intent
6. Go to OAuth2 > URL Generator, select scopes: bot
7. Select bot permissions: Read Messages/View Channels, Send Messages, Read Message History
8. Use the generated URL to invite the bot to your server(s)

Installation

npm install @striderlabs/mcp-discord

Configuration

Set the DISCORD_TOKEN environment variable to your bot token:

export DISCORD_TOKEN=your_bot_token_here

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-discord"],
      "env": {
        "DISCORD_TOKEN": "your_bot_token_here"
      }
    }
  }
}

Available Tools

get_servers

List all Discord servers (guilds) the bot is a member of.

No parameters required.

get_channels

List channels in a Discord server.

Parameter	Type	Required	Description
server_id	string	Yes	Discord server (guild) ID
channel_type	string	No	Filter: text, voice, category, or all (default: text)

get_messages

Fetch recent messages from a channel.

Parameter	Type	Required	Description
channel_id	string	Yes	Discord channel ID
limit	number	No	Number of messages to fetch (1–100, default: 50)
before_message_id	string	No	Fetch messages before this ID (pagination)

send_message

Send a message to a Discord channel.

Parameter	Type	Required	Description
channel_id	string	Yes	Discord channel ID
content	string	Yes	Message text to send
reply_to_message_id	string	No	Reply to a specific message ID

get_dms

Get direct message conversations the bot has had.

Parameter	Type	Required	Description
limit	number	No	Messages per conversation (1–50, default: 20)

Note: DMs are only available after the bot has received at least one DM from a user.

search_messages

Search for messages containing specific text within a server.

Parameter	Type	Required	Description
server_id	string	Yes	Discord server ID
query	string	Yes	Text to search for
channel_id	string	No	Limit search to a specific channel
limit	number	No	Max results (1–100, default: 25)

Note: Search scans recent messages (up to 100 per channel). For historical search, use Discord's built-in search.

Getting Channel and Server IDs

Enable Developer Mode in Discord (Settings > Advanced > Developer Mode), then right-click any server or channel to copy its ID.

License

MIT