Which integrations are available for this server?

Provides tools for interacting with Discord through a user account, including listing servers and channels, reading and sending messages or direct messages, searching history, managing emoji reactions, and retrieving server or user information.

How do I use discord-user-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@discord-user-mcp summarize the last 10 messages in the #general channel" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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.