Discord User Mcp

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 → 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

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: olivier-motium
• Source: olivier-motium/discord-user-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.