Skip to main content
Glama
Sign In
olivier-motium

discord-user-mcp

by olivier-motium
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

discord-user-mcp

Discord MCP server using user tokens. No bot setup, no Developer Portal, no intents — just your token and go.

Built for Claude Code and any MCP-compatible client.

Why user tokens?

Every other Discord MCP server requires creating a bot application, configuring intents, and inviting the bot to your server. This one uses your existing Discord session — the same access you already have in the app.

Trade-off: Using user tokens for automation is against Discord's ToS. This is a personal tool for your own account on your own machine. Use responsibly.

Related MCP server: Discord MCP

Setup

1. Get your Discord token

Your token is stored encrypted in the Discord app's local storage. You can find it by:

  • Opening Discord in a browser → DevTools → Network tab → any request → Authorization header

  • Or extracting it from the desktop app's LevelDB storage (macOS: ~/Library/Application Support/discord/Local Storage/leveldb/)

2. Add to Claude Code

claude mcp add discord -e DISCORD_TOKEN=your-token-here -- node /path/to/discord-user-mcp/dist/index.js

With a default server:

claude mcp add discord \
  -e DISCORD_TOKEN=your-token-here \
  -e DISCORD_DEFAULT_GUILD=your-server-id \
  -- node /path/to/discord-user-mcp/dist/index.js

3. Build from source

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

Tools (14)

Core

Tool

Description

discord_list_guilds

List servers you're in

discord_list_channels

List channels grouped by category

discord_read_messages

Read channel history with pagination

discord_send_message

Send a message, optionally as a reply

discord_search

Search messages by content, author, channel, date, attachment type

Essential

Tool

Description

discord_list_dms

List DM conversations

discord_send_dm

Send a DM (by user ID or channel ID)

discord_react

Add emoji reaction to a message

discord_pinned_messages

Get pinned messages from a channel

discord_list_threads

List active threads in a server

discord_guild_info

Server details, roles, features

Additional

Tool

Description

discord_edit_message

Edit your own message

discord_delete_message

Delete your own message

discord_user_info

User profile with server roles

Configuration

Environment Variable

Required

Description

DISCORD_TOKEN

Yes

Your Discord user token

DISCORD_DEFAULT_GUILD

No

Default server ID — tools that need a guild will use this when not specified

Design choices

  • Plain text output — no raw JSON. Messages formatted as [2024-01-15 14:32] alice: content. IDs always inline for tool chaining.

  • No discord.js — raw fetch against Discord API v10. Zero runtime deps beyond MCP SDK.

  • Rate limit handling — automatic retry with retry_after + jitter, up to 3 attempts.

  • Search is the star — accepts usernames (resolved to IDs internally), date strings (YYYY-MM-DD converted to snowflakes), and all Discord search filters.

  • Conservative defaults — 25 messages per read, not 100. Keeps output manageable for AI.

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • discord-mcp

    yone-k
    A
    license
    B
    quality
    D
    maintenance
    Enables MCP clients to interact with Discord servers, allowing operations such as sending messages and reading message history through the Discord API.
    23
    140 npm
    MIT

  • Discord MCP

    PckyDev
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables managing Discord servers through a bot, including channel and role administration, messaging, and direct Discord API calls via MCP tools.
    2
    MIT

  • discord-mcp

    nesquickwe
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables MCP clients to control a logged-in Discord account through 70+ tools: browsing guilds and channels, sending and reacting to messages, moderating members, managing channels, roles, emojis, and webhooks, plus searching and analyzing captured message history stored in SQLite. Authenticates using tokens already cached by the local Discord client, requiring no bot account or manual token setup.
    140 npm
    MIT

  • discord-web

    VKirill
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables an MCP client to read Discord servers, channels, threads, and messages, and to send messages, replies, reactions, and GIFs through an already-open Discord Web tab via a local Chrome extension and 127.0.0.1 bridge, without using a bot or the Discord HTTP API.
    8 npm
    MIT