README.md
Discord MCP server using user tokens for seamless message management.
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
Tools (14)
discord_list_guildsList servers you're indiscord_list_channelsList channels grouped by categorydiscord_read_messagesRead channel history with paginationdiscord_send_messageSend a message, optionally as a replydiscord_searchSearch messages by content, author, channel, date, attachment typediscord_list_dmsList DM conversationsdiscord_send_dmSend a DM (by user ID or channel ID)discord_reactAdd emoji reaction to a messagediscord_pinned_messagesGet pinned messages from a channeldiscord_list_threadsList active threads in a serverdiscord_guild_infoServer details, roles, featuresdiscord_edit_messageEdit your own messagediscord_delete_messageDelete your own messagediscord_user_infoUser profile with server rolesEnvironment Variables
DISCORD_TOKENrequiredYour Discord user tokenDISCORD_DEFAULT_GUILDDefault server ID for tools that need a guildConfiguration
claude_desktop_config.json
{"mcpServers": {"discord": {"command": "node", "args": ["/path/to/discord-user-mcp/dist/index.js"], "env": {"DISCORD_TOKEN": "your-token-here"}}}}Try it
→List all the servers I am currently a member of.
→Search for messages from 'alice' in the general channel containing the word 'meeting'.
→Send a message to the current channel saying 'I am currently busy, will reply later'.
→Get the pinned messages from the project-updates channel.
→List my recent direct message conversations.