discord-mcp
Provides tools to read Discord servers, channels, threads, and DMs, and to post messages as a bot via Discord's REST API. Supports listing servers and channels, reading recent messages across a server, and sending messages with mention safeguards.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@discord-mcp Summarize everything posted in my Discord server today"
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-mcp
Read Discord and post to it from a Claude chat, on demand, with no bot process left running.
"Summarize what happened in my server today." "Post this to #announcements."
Why another Discord MCP server?
Most Discord MCP servers log in to the Discord gateway as a bot and stay connected while the client runs. That is fine for one session. It gets awkward when:
every Claude session that loads the server opens another gateway connection for the same bot, and
you already run something on that bot token, such as the official Claude Code Discord channel plugin.
discord-mcp never connects to the gateway. A tool call makes a few REST requests and returns.
Typical gateway-based server | discord-mcp | |
Connection | Bot logs in and stays connected per session | None. REST calls only while a tool runs |
Ten Claude sessions open | Ten bot logins | Nothing running between calls |
Next to the Claude Code channel plugin | A second login on the same token | Reads the plugin's token file. No conflict |
"What happened today?" | Read channel by channel |
|
Mass pings | Up to the model |
|
Built to sit next to the official Claude Code Discord plugin
Claude Code has an official Discord channel plugin (discord@claude-plugins-official).
It pushes your Discord DMs into a running session, so you can message Claude from your phone.
Its tools only work in chats you have allowlisted, by design.
discord-mcp covers the other direction.
From any Claude chat, ask Claude to read any channel the bot can see, or to post somewhere.
Point both at the same bot: discord-mcp reads the plugin's ~/.claude/channels/discord/.env, so there is one token to manage.
Related MCP server: claude-discord-mcp
Tools
Tool | What it does |
| Servers the bot is in |
| Channels and active threads, in category order |
| Messages in one channel, thread or DM, oldest first (up to 500) |
| Recent messages across every channel and active thread in a server |
| Post as the bot. Splits text over 2,000 characters at line breaks |
Messages come back compact: id, time, author, content, plus reply_to, attachments, embeds, thread_id, bot or system when present.
User mentions like <@123> are rewritten to @name.
Setup
1. Create a bot
Skip this if you already set up the Claude Code Discord channel plugin.
In the Discord Developer Portal, create an application. Under Bot, click Reset Token and copy it.
Under Bot → Privileged Gateway Intents, turn on Message Content Intent. Without it, Discord returns other people's messages with empty text.
Invite the bot to each server you want to read. Replace
<APPLICATION_ID>:https://discord.com/oauth2/authorize?client_id=<APPLICATION_ID>&scope=bot&permissions=274878008384This grants View Channels, Send Messages, Send Messages in Threads, Read Message History, Attach Files and Add Reactions.
2. Give it the token
Use either one:
the
DISCORD_BOT_TOKENenvironment variable, ora file at
~/.claude/channels/discord/.envwith one line,DISCORD_BOT_TOKEN=...(runchmod 600on it).
If you ran /discord:configure for the channel plugin, the file already exists.
3. Add it to Claude Code
claude mcp add --scope user discord -- uvx --from git+https://github.com/qgasdg/discord-mcp discord-mcpFor Claude Desktop, add this to claude_desktop_config.json:
{
"mcpServers": {
"discord": {
"command": "uvx",
"args": ["--from", "git+https://github.com/qgasdg/discord-mcp", "discord-mcp"]
}
}
}Configuration
Variable | Default | Purpose |
| none | Bot token. Takes priority over the |
|
| Where to find |
| local timezone | IANA timezone for timestamps, such as |
Example prompts
"List my Discord servers and their channels."
"Read the last 24 hours across the server and summarize it by channel."
"What did people say about the release in #general this week?"
"Reply to that last message in #support: we're looking into it."
Limits
The bot only sees servers it was invited to and channels it may view. Private channels need the bot's role added.
It cannot read your personal account or your own DMs. Doing that needs a self-bot, which breaks Discord's terms.
Bots cannot use Discord's search API. "Search" means reading recent messages and letting Claude filter them.
Archived forum posts are not listed. Active threads are.
Messages are posted as the bot, not as you.
Safety
send_messagetells Claude to show you the channel and text and get your OK before posting. Claude Code also asks before an MCP tool runs, unless you have allowed it.Anyone in a server can write text that Claude will read. Treat message content as untrusted input, and be careful about allowing
send_messagewithout a prompt.
Development
git clone https://github.com/qgasdg/discord-mcp && cd discord-mcp
python3 -m venv .venv && .venv/bin/pip install -e .
claude mcp add --scope user discord -- "$PWD/.venv/bin/python" "$PWD/discord_mcp.py"한국어 요약
Claude 채팅에서 필요할 때 디스코드 채널을 읽고 메시지를 보내는 MCP 서버입니다. 봇이 디스코드에 계속 접속해 있지 않고, 도구를 부를 때만 REST API를 호출합니다. 그래서 세션을 여러 개 열어도 봇이 중복 접속하지 않습니다. Claude Code 공식 디스코드 채널 플러그인과 같은 봇 토큰 파일을 함께 쓰고, 같이 켜도 충돌하지 않습니다. 설치는 위 "Setup" 순서를 따르세요.
License
MIT
Available Tools
5 toolslist_channelsA
List a server's channels and active threads, in category order.
server_id: a server ID from list_servers Channels of type "forum" hold no messages themselves; read their threads instead.
Inputs: server_id (required). Returns: result
list_serversA
List the Discord servers (guilds) the bot is a member of.
Inputs: no named parameters. Returns: result
read_messagesA
Read messages from one channel, thread, or DM, oldest first.
channel_id : a channel or thread ID from list_channels limit : maximum number of messages (default 50, max 500) since_hours: if set, only messages from the last N hours. e.g. 24 = the last day before : read messages older than this message ID (to page further back)
Inputs: channel_id (required), limit, before, since_hours.
read_server_recentA
Collect recent messages from every channel and active thread in a server.
server_id : a server ID from list_servers since_hours : how many hours back to read (default 24) per_channel_limit: maximum messages per channel (default 100, max 500) Channels with no new messages are skipped without an API call. Channels the bot cannot view are listed under "skipped" with the reason.
Inputs: server_id (required), since_hours, per_channel_limit.
send_messageA
Post a message as the bot to a channel, thread, or DM.
Always show the user the target channel and the exact text, and get their confirmation, before calling this. channel_id: target channel or thread ID content : message text. Over 2000 characters, it is split at line breaks reply_to : message ID to reply to (optional) @everyone, @here, and role mentions never ping; only user mentions do.
Inputs: content (required), channel_id (required), reply_to.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
The five tools have mostly distinct purposes: listing servers, listing channels, reading messages, reading a server's recent messages, and sending messages. The only potential overlap is between read_messages and read_server_recent, but their scope (one channel vs. all channels in a server) is clearly described.
All tool names follow a consistent snake_case verb_noun pattern (list_servers, list_channels, read_messages, read_server_recent, send_message). The slight variation in read_server_recent is still predictable and readable.
Five tools is a well-scoped size for a Discord bot focused on discovering servers/channels, reading messages, and sending messages. Each tool has a clear role and there is no redundant clutter.
The core read-and-send workflow is covered, but the surface lacks message editing/deletion, direct message lookup by ID, and any way to discover DM channels despite read_messages and send_message claiming DM support. These are notable gaps for a general Discord messaging toolset.
Maintenance
Related MCP Connectors
Discord MCP server for ChatGPT, Claude and any AI agent: list servers and channels, read channel messages, search messages, send message, reply to message, send DM, read mentions and assign role in your own Discord account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Discord yourself; Cotlet does not store your password and you need no Discord API key. About the official Discord API: Yes, Discord has an official API for bots and OAuth2 apps, but it acts as a bot that a server manager adds, not as you, and Discord has no official MCP server for it (checked 5 Nov 2026). The MCP server on Discord's docs site only searches documentation. Setup and FAQ: https://cotlet.dev/integrations/discord-api-mcp-server
Control your Discord community: send/read messages, manage channels and forums, and handle webhook…
Connect a Discord bot (bot token from the developer portal) to read/send messages, list guilds and c
Build and change Discord bots by describing them: slash commands, events, embeds, modals and data.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with Discord through the REST API and real-time events, supporting message management, user info, channel operations, and more with security controls.23 npm1MIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude Code to interact with Discord servers, including sending messages, reading channels, managing threads, and adding reactions via natural language commands.8 npmMIT
- FlicenseNot gradedqualityDmaintenanceEnables LLMs to read messages, discover channels, send messages, and monitor Discord communities using the Discord HTTP API.-
- AlicenseAqualityCmaintenanceEnables AI assistants to interact with Discord through the REST API, supporting message reading and sending, channel and guild management, threads, pins, and reactions.17MIT