Discord User

This MCP server lets you control Discord using your own user token through MCP-compatible clients. It provides direct access to your Discord data and actions without relying on bot setup or Developer Portal configurations, making it a practical tool for personal automation and workflows on your own machine.

How to use

You will run this MCP server alongside your Claude Code or other MCP client. Provide your Discord user token when configuring the client. You can either start the server directly with a node runtime or use Claude Code to register it as an MCP service. The available tools cover listing guilds and channels, reading messages, sending messages and DMs, reacting to messages, managing pins and threads, and inspecting user profiles.

How to install

Prerequisites: you need Node.js and npm installed on your system. You also need access to a terminal or command prompt.

# Step 1: Build from source (optional if you only use the prebuilt distribution)
git clone https://github.com/olivier-motium/discord-user-mcp.git
cd discord-user-mcp
npm install
npm run build

# Step 2: Add the MCP service to Claude Code (example without a default guild)
claude mcp add discord -e DISCORD_TOKEN=your-token-here -- node /path/to/discord-user-mcp/dist/index.js

# Step 3: Add the MCP service to Claude Code with a default guild (server ID)
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

Configuration and environment

You must provide your Discord user token to run the MCP server. The default guild is optional and used when a specific tool requires a guild but none is provided in a particular command.

Environment variables used by the runtime include:

Security and safety notes

Using a user token for automation is against Discord’s ToS. This tool is intended for personal use on your own machine. Treat your token as highly sensitive information and avoid sharing it. Rotate tokens if you suspect exposure.

Notes on output and behavior

The MCP client will present plain text outputs, including timestamps and inline IDs for tool chaining. It uses raw fetch calls to the Discord API v10 and includes automatic rate-limit handling with retry logic.

Troubleshooting

If you encounter authentication errors, verify that the token is correct and that it is being provided to the MCP client as shown in the example configurations. Check that the path to the built distribution is accurate in your command. Ensure you are using Node.js and npm versions compatible with the project.

Available tools

discord_list_guilds

List servers you are a member of.

discord_list_channels

List channels grouped by category within a server.

discord_read_messages

Read channel history with pagination to fetch messages.

discord_send_message

Send a message to a channel or as a reply to a message.

discord_search

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

discord_list_dms

List direct message conversations.

discord_send_dm

Send a direct message to a user or chat.

discord_react

Add an emoji reaction to a message.

discord_pinned_messages

Retrieve pinned messages from a channel.

discord_list_threads

List active threads in a server.

discord_guild_info

Fetch server details, roles, and features.

discord_edit_message

Edit your own previously sent message.

discord_delete_message

Delete your own previously sent message.

discord_user_info

Fetch user profile information including server roles.