Awesome MCP › Social & Messaging

v-3/discordmcp

⭐ 231 TypeScript added to this list on 2025-05-14 repository created 2025-01-21

v-3/discordmcp is a compact TypeScript MCP server that lets an LLM read from and write to Discord channels through the Discord API. It exposes two tools. send-message posts a message to a channel and takes the channel name or ID, the message text and an optional server name or ID, which is required when the bot is in more than one server. read-messages returns recent messages from a channel and accepts the same channel and server parameters plus an optional limit that defaults to 50 and is capped at 100. Both tools accept human-readable names as well as numeric identifiers, and the server discovers the servers and channels the bot can see automatically, validating input and returning explicit errors for ambiguous or unavailable names. Setup follows a standard Node.js flow: clone the repository, install dependencies, put a Discord bot token in a .env file as DISCORD_TOKEN and build with npm. The built entry point is then registered in claude_desktop_config.json as a stdio command with the token supplied in the env block. The bot must be invited to the target server with the Read Messages and View Channels, Send Messages and Read Message History permissions, and Node.js 16 or newer is required. Channel access is limited to what the bot has been granted, so the Discord permission model remains the boundary, and the README states that message sending is expected to go through explicit user approval in the client. The project suggests testing with the MCP Inspector and gives example prompts such as reading the last five messages from a general channel or posting a meeting reminder to an announcements channel. It is MIT licensed and aimed at users who want a chat assistant to take part in a Discord workspace.

https://github.com/v-3/discordmcp

discordchatmessagingmcp-servertypescriptdiscord-bot