🤖 Discord MCP Server

Give Claude full access to Discord.
Read messages, send messages, manage threads, react, search history, send DMs — all through natural conversation.

What is this?

Discord MCP Server is a Model Context Protocol server that bridges Claude and Discord. Once connected, you can talk to Claude in plain English and it will interact with your Discord account — no scripting, no dashboards, no manual API calls.

Uses a Discord user token — no bot registration needed.

Related MCP server: Discord MCP Server

Demo

You: "What are the last 15 messages in #general?"
You: "Send a message to #announcements: deployment done ✅"
You: "Search #support for messages about 'login error'"
You: "DM user 123456789 and say hey, got a minute?"
You: "Create a thread called 'Release notes' from that last message"
You: "What are my recent mentions across all servers?"
You: "React to message 987654321 with 👍"

Tools

Requirements

• Node.js 18+

• Your Discord user token

Setup

1. Get your Discord User Token

1. Open Discord in your browser at discord.com/app

2. Press F12 → Network tab

3. Send any message or switch a channel

4. Find any request to discord.com/api, click it, look at Request Headers

5. Copy the value of the Authorization header — that's your token

Or paste this in the browser Console:

(webpackChunkdiscord_app.push([[''],{},e=>{m=[];for(let c in e.c)m.push(e.c[c])}]),m)
  .find(m=>m?.exports?.default?.getToken!==void 0).exports.default.getToken()

⚠️ Your user token = your password. Never share it, commit it to git, or put it in public config files.

2. Install

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

3. Connect to Claude Desktop

Edit your Claude Desktop config:

• macOS → ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows → %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "discord": {
      "command": "node",
      "args": ["/absolute/path/to/discord-mcp-server/dist/index.js"],
      "env": {
        "DISCORD_USER_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

Restart Claude Desktop — the Discord tools will appear automatically.

4. Connect to Claude Code CLI

claude mcp add discord \
  --env DISCORD_USER_TOKEN=YOUR_TOKEN_HERE \
  -- node /absolute/path/to/discord-mcp-server/dist/index.js

Configuration

Rate-Limit Protection

Discord enforces strict limits on user tokens. Three layers of protection are built in:

Global throttle

Every REST call passes through a shared gate that enforces a minimum gap of REQUEST_DELAY_MS (default 5 seconds) between consecutive requests.

Exponential back-off

On a 429 Too Many Requests response, the server automatically retries:

attempt 1 → wait 2s
attempt 2 → wait 4s
attempt 3 → wait 8s
attempt 4 → wait 16s  (then give up)

Hard scan caps

Bulk tools that touch many channels are capped to prevent runaway API storms:

To tune the throttle:

"env": {
  "DISCORD_USER_TOKEN": "...",
  "REQUEST_DELAY_MS": "2000"
}

Architecture

╔══════════════════╗
║  Claude / MCP    ║
║     Client       ║
╚════════╤═════════╝
         │ stdio (JSON-RPC)
╔════════▼═════════╗
║  discord-mcp     ║  ← this server
║  (Node.js)       ║
╚════════╤═════════╝
         │ discord.js (WebSocket + REST)
╔════════▼═════════╗
║  Discord API     ║
╚══════════════════╝

The server speaks MCP over stdio — no open ports, no HTTP server. The MCP host (Claude Desktop, Claude Code, etc.) spawns it as a subprocess.

Development

# Dev mode — no build step needed
DISCORD_USER_TOKEN=your_token npm run dev

# Build
npm run build

# Run built output
DISCORD_USER_TOKEN=your_token npm start

Made by Claude for Claude 🤖

Built with discord.js · Model Context Protocol SDK