Skip to main content
Glama
discord-mcp

discord-mcp

by vovafes

๐Ÿค– Discord MCP Server

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

Made by Claude for Claude MCP License: MIT


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: MCP-Discord

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

Tool

Description

get_bot_info

Connected account info (username, ping, server count)

list_guilds

All Discord servers you're in

get_guild_info

Server details: members, boosts, verification level, etc.

list_channels

All channels in a server, sorted by position

get_channel_info

Info about a specific channel

get_messages

Fetch recent messages (up to 100), with pagination

send_message

Send a message, with optional reply

send_embed

Send a rich embed (title, description, fields, color, footer)

edit_message

Edit one of your own messages

delete_message

Delete a message

pin_message

Pin or unpin a message

add_reaction

React with a Unicode or custom emoji

create_thread

Start a thread from a message or create a standalone one

list_members

List server members with roles (up to 1 000)

get_user_info

Full profile of a user in a server

search_messages

Keyword search across recent channel history

get_pinned_messages

All pinned messages in a channel

get_dm_channels

List your open DM conversations

send_dm

Send a direct message to any user by ID

get_mentions

Recent messages that mention you across all servers


Requirements


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

Variable

Required

Default

Description

DISCORD_USER_TOKEN

โœ…

โ€”

Your Discord user token

REQUEST_DELAY_MS

โŒ

5000

Delay between REST calls in ms. Lower = faster, higher = safer.


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:

Tool

Limit

search_messages

Max 500 messages (5 batches ร— 100)

get_mentions

Max 20 channels scanned across all servers

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

Available Tools

20 tools
add_reactionA

Add an emoji reaction to a message

Inputs: emoji (required), channel_id (required), message_id (required).

create_threadA

Create a thread from a message or a standalone thread in a channel

Inputs: name (required), channel_id (required), message_id, auto_archive_minutes.

delete_messageB

Delete a message

Inputs: channel_id (required), message_id (required).

edit_messageA

Edit one of your own messages

Inputs: content (required), channel_id (required), message_id (required).

get_channel_infoA

Get information about a specific channel

Inputs: channel_id (required).

get_dm_channelsA

List open DM conversations

Inputs: no named parameters.

get_guild_infoB

Get detailed information about a Discord server

Inputs: guild_id (required).

get_meA

Get information about the connected Discord account

Inputs: no named parameters.

get_mentionsA

Find recent messages that mention you (scans up to 20 channels across all servers)

Inputs: limit.

get_messagesB

Retrieve recent messages from a channel

Inputs: channel_id (required), after, limit, before.

get_pinned_messagesB

Get all pinned messages in a channel

Inputs: channel_id (required).

get_user_infoB

Get a user's profile in a server

Inputs: user_id (required), guild_id (required).

list_channelsA

List all channels in a Discord server

Inputs: guild_id (required).

list_guildsA

List all Discord servers the account is in

Inputs: no named parameters.

list_membersB

List members in a server

Inputs: guild_id (required), limit.

pin_messageB

Pin or unpin a message

Inputs: channel_id (required), message_id (required), pin.

search_messagesA

Search for messages containing a keyword in a channel (scans up to 500 recent messages)

Inputs: query (required), channel_id (required), limit.

send_dmA

Send a direct message to a user by their ID

Inputs: content (required), user_id (required).

send_embedA

Send a rich embed message to a channel

Inputs: title (required), channel_id (required), url, color, +3 more.

send_messageC

Send a message to a channel

Inputs: content (required), channel_id (required), reply_to.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelogโ€ฆ

    TDQS

    A3.7/5.0

    Scored across 20 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action: account, guild, channel, message, member, DM. Even similar-sounding operations like get_messages, search_messages, and get_pinned_messages have clear, non-overlapping purposes.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (list_guilds, get_channel_info, send_message, add_reaction). The verbs are predictably chosen: list for collections, get for details, send for output, etc.

    Tool Count4/5

    20 tools is slightly above the ideal 3-15 range, but the count is justified by the broad scope of Discord interactions covered. Each tool serves a distinct purpose and none feel redundant.

    Completeness4/5

    The set covers the core lifecycle of Discord messaging (read, send, edit, delete, pin, react) and server/member info. Minor gaps exist, such as no direct fetch by message ID, but the workflows are generally complete.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      B
      maintenance
      A Discord Model Context Protocol server that enables AI assistants to interact with Discord, providing functionality for sending messages, managing channels, handling forum posts, and working with reactions.
      46
      1,578 npm
      111
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A Discord MCP server that enables AI assistants to interact with Discord platforms, providing functionalities like sending messages, managing channels, creating forum posts, and handling webhooks.
      21
      1
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A Discord Model Context Protocol server that enables AI assistants to interact with Discord by sending messages, managing channels, handling forum posts, managing webhooks, and processing reactions.
      22
      82 npm
      5
      MIT