Discord MCP Server

A Model Context Protocol (MCP) server that gives Claude (and any other MCP-compatible AI) full access to Discord using a user token — read and send messages, manage threads, react, search message history, send DMs, and more.

Note: This server uses a Discord user token, not a bot token. No app registration needed — just grab your token and go.

Demo

Ask Claude things like:

• "What are the latest 20 messages in #general?"

• "Send a message to #announcements saying the deployment is done."

• "Search #support for messages about 'login error'."

• "Send a DM to user 123456789 saying 'hey, got a minute?'"

• "What are my recent mentions across all servers?"

• "Create a thread called 'Bug report' on that last message."

• "List all members of my server."

Related MCP server: MCP-Discord

Features

Requirements

• Node.js 18 or later

• Your Discord user token

Setup

1. Get your Discord User Token

1. Open Discord in your browser (discord.com/app).

2. Press F12 to open DevTools → Network tab.

3. Send any message or switch channels.

4. Filter requests by messages or any API call, click one, and look at the Request Headers.

5. Find the Authorization header — its value is your user token.

Alternatively, in the Console tab paste:

(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 is like a password. Never share it, commit it to git, or expose it publicly. Anyone with your token has full access to your account.

2. Install the MCP Server

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

3. Configure Claude Desktop (or any MCP client)

Open your Claude Desktop config file:

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

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

Add the discord-mcp server entry:

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

Restart Claude Desktop. The Discord tools will appear in Claude's tool list.

4. Configure Claude Code CLI

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

Usage Examples

Once connected, talk to Claude naturally:

"List all my Discord servers."
"Show the 20 most recent messages in channel ID 123456789."
"Send 'Hello!' to channel 987654321."
"Search #help for 'connection refused'."
"Pin message ID 111222333 in channel 444555666."
"Create a thread called 'Discussion' from message 777888999."
"Add a 👍 reaction to message 000111222 in channel 333444555."
"List all members in guild 666777888."
"Send a DM to user 111222333 saying 'are you free?'"
"Show my recent mentions."

Environment Variables

Rate-Limit Protection

Discord enforces strict rate limits on user tokens. The server has three layers of protection built in:

1. Per-request throttle Every REST call goes through a shared queue that enforces a minimum gap of REQUEST_DELAY_MS (default 1 000 ms) between consecutive requests. This keeps the request rate well below Discord's per-route limits.

2. Exponential back-off on 429 If Discord returns a rate-limit response anyway, the server automatically retries — waiting 2 s → 4 s → 8 s → 16 s before each attempt (up to 4 retries, capped at 30 s).

3. Hard scan caps Bulk scanning tools that touch many channels at once are capped to prevent runaway API usage:

• search_messages — scans at most 5 batches × 100 messages = 500 messages

• get_mentions — scans at most 20 channels across all servers

If you're on many large servers or see errors, increase REQUEST_DELAY_MS:

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

Development

# Run in dev mode (no build step)
DISCORD_USER_TOKEN=your_token npm run dev

# Build
npm run build

# Run built output
DISCORD_USER_TOKEN=your_token npm start

Architecture

Claude / MCP Client
       │
       │ stdio (JSON-RPC)
       ▼
discord-mcp (Node.js)
       │
       │ discord.js (WebSocket + REST)
       ▼
  Discord API

The server speaks MCP over stdio — no HTTP port, no network exposure. Claude Desktop (or any MCP host) spawns the process directly.

License

MIT