Discord MCP Server

To use the Discord MCP server, you must first clone the repository, install dependencies, and provide a Discord bot token.

Prerequisites

• Node.js 16.x or higher
• A Discord bot token
• The bot must have the following permissions in your Discord server:
  • Read Messages/View Channels
  • Send Messages
  • Read Message History

Installation Steps

1. Clone the repository:

   git clone https://github.com/yourusername/discordmcp.git
   cd discordmcp

2. Install dependencies:

   npm install

3. Create a .env file in the root directory and add your token:

   DISCORD_TOKEN=your_discord_bot_token_here

4. Build the server:

   npm run build

git clone https://github.com/yourusername/discordmcp.git
cd discordmcp
npm install
# Create .env with DISCORD_TOKEN
npm run build

To integrate the Discord MCP server with Claude for Desktop, add the server configuration to your claude_desktop_config.json file.

Config File Locations:

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

After updating the configuration, restart Claude for Desktop.

{
  "mcpServers": {
    "discord": {
      "command": "node",
      "args": ["path/to/discordmcp/build/index.js"],
      "env": {
        "DISCORD_TOKEN": "your_discord_bot_token_here"
      }
    }
  }
}

To run the Discord MCP server, you must provide a valid Discord Bot Token via an environment variable.

Required Environment Variables

• DISCORD_TOKEN: The token for your Discord bot. This token must have the necessary intents enabled in the Discord Developer Portal (specifically Guilds, GuildMessages, and MessageContent).

Setup Note

The server uses dotenv to load variables, so you can also define this in a .env file in the project root.

export DISCORD_TOKEN=your_token_here

You can verify the server is working correctly by using the MCP Inspector tool.

npx @modelcontextprotocol/inspector node build/index.js

The read-messages tool allows an LLM to fetch recent messages from a Discord channel.

Parameters:

• channel (required): Channel name (e.g., "general") or ID.
• limit (optional): Number of messages to fetch. Default is 50, maximum is 100.
• server (optional): Server name or ID (required if the bot is in multiple servers).

{
  "channel": "general",
  "limit": 10
}

The send-message tool allows an LLM to send a message to a specific Discord channel. You can specify a channel by name or ID. If the bot is present in multiple servers, providing the server parameter (name or ID) is required to disambiguate.

{
  "channel": "general",
  "message": "Hello from MCP!"
}