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.
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 →
Authorizationheader - 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
fetchagainst 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-DDconverted to snowflakes), and all Discord search filters. - Conservative defaults — 25 messages per read, not 100. Keeps output manageable for AI.
License
MIT