Discord MCP Server
by
Enables large language models to interact with Discord channels, allowing them to send and read messages through Discord's API while keeping user control and security.
Discord MCP Server Overview
What is Discord MCP Server about?
The server acts as a bridge between LLMs (e.g., Claude) and Discord, exposing two tools – send-message and read-messages – that let the model query recent chat history or post new content in any channel the bot can access.
How to use Discord MCP Server?
- Clone & install
git clone https://github.com/v-3/discordmcp.git cd discordmcp npm install - Configure – create a
.envfile containingDISCORD_TOKEN=your_bot_token. - Build the TypeScript source:
npm run build - Add to Claude (or any MCP‑compatible client) by pointing to the built entry point:
{ "mcpServers": { "discord": { "command": "node", "args": ["path/to/discordmcp/build/index.js"], "env": { "DISCORD_TOKEN": "your_discord_bot_token_here" } } } } - Restart the client. The LLM can now call the
send-messageandread-messagestools.
Key features of Discord MCP Server
- Send messages to any channel by name or ID.
- Read recent messages with configurable limits (default 50, max 100).
- Automatic discovery of servers and channels when the bot is in multiple guilds.
- Robust error handling and input validation.
- Simple JSON‑based tool definitions that integrate with any MCP‑compatible model.
Use cases of Discord MCP Server
- Automated monitoring: let an LLM fetch the latest announcements and summarize them.
- Interactive bots: allow Claude to respond to user queries by posting back into Discord after user approval.
- Knowledge retrieval: pull recent discussion threads for context‑aware assistance.
- Team workflows: automate routine posts (e.g., meeting reminders) directly from an AI assistant.
FAQ from the Discord MCP Server
Q: Which permissions does the Discord bot need? A: Read Messages/View Channels, Send Messages, and Read Message History.
Q: Can the server handle multiple Discord guilds?
A: Yes. Provide the server parameter when the bot belongs to more than one guild.
Q: Is the bot token exposed?
A: The token is stored only in a local .env file and never committed to the repository.
Q: How many messages can be fetched at once? A: Up to 100 messages per request; the default is 50.
Q: Do I need to compile the TypeScript code each time?
A: Only after code changes. Use npm run dev for continuous recompilation during development.
Discord MCP Server's README
Discord MCP Server
A Model Context Protocol (MCP) server that enables LLMs to interact with Discord channels, allowing them to send and read messages through Discord's API. Using this server, LLMs like Claude can directly interact with Discord channels while maintaining user control and security.
Features
- Send messages to Discord channels
- Read recent messages from channels
- Automatic server and channel discovery
- Support for both channel names and IDs
- Proper error handling and validation
Prerequisites
- Node.js 16.x or higher
- A Discord bot token
- The bot must be invited to your server with proper permissions:
- Read Messages/View Channels
- Send Messages
- Read Message History
Setup
- Clone this repository:
git clone https://github.com/yourusername/discordmcp.git
cd discordmcp
- Install dependencies:
npm install
- Create a
.envfile in the root directory with your Discord bot token:
DISCORD_TOKEN=your_discord_bot_token_here
- Build the server:
npm run build
Usage with Claude for Desktop
-
Open your Claude for Desktop configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
-
Add the Discord MCP server configuration:
{
"mcpServers": {
"discord": {
"command": "node",
"args": ["path/to/discordmcp/build/index.js"],
"env": {
"DISCORD_TOKEN": "your_discord_bot_token_here"
}
}
}
}
- Restart Claude for Desktop
Available Tools
send-message
Sends a message to a specified Discord channel.
Parameters:
server(optional): Server name or ID (required if bot is in multiple servers)channel: Channel name (e.g., "general") or IDmessage: Message content to send
Example:
{
"channel": "general",
"message": "Hello from MCP!"
}
read-messages
Reads recent messages from a specified Discord channel.
Parameters:
server(optional): Server name or ID (required if bot is in multiple servers)channel: Channel name (e.g., "general") or IDlimit(optional): Number of messages to fetch (default: 50, max: 100)
Example:
{
"channel": "general",
"limit": 10
}
Development
- Install development dependencies:
npm install --save-dev typescript @types/node
- Start the server in development mode:
npm run dev
Testing
You can test the server using the MCP Inspector:
npx @modelcontextprotocol/inspector node build/index.js
Examples
Here are some example interactions you can try with Claude after setting up the Discord MCP server:
- "Can you read the last 5 messages from the general channel?"
- "Please send a message to the announcements channel saying 'Meeting starts in 10 minutes'"
- "What were the most recent messages in the development channel about the latest release?"
Claude will use the appropriate tools to interact with Discord while asking for your approval before sending any messages.
Security Considerations
- The bot requires proper Discord permissions to function
- All message sending operations require explicit user approval
- Environment variables should be properly secured
- Token should never be committed to version control
- Channel access is limited to channels the bot has been given access to
Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
License
This project is licensed under the MIT License - see the LICENSE file for details.
Support
If you encounter any issues or have questions:
- Check the GitHub Issues section
- Consult the MCP documentation at https://modelcontextprotocol.io
- Open a new issue with detailed reproduction steps
Discord MCP Server Reviews
Login Required
Please log in to share your review and rating for this MCP.
Actions
Discord MCP Server's Information
- Author
- v-3
- Category
- Social Media
- Language
- TypeScript
- Version
- v1.0.0
- Stars
- 127
- Updated
- 2 months ago
Configuration
{
"mcpServers": {
"discord": {
"command": "node",
"args": [
"path/to/discordmcp/build/index.js"
],
"env": {
"DISCORD_TOKEN": "your_discord_bot_token_here"
}
}
}
}Claude Code (Terminal)
claude mcp add discord node path/to/discordmcp/build/index.jsConfigure Clients
Similar MCP Servers like Discord MCP Server
Explore related MCPs that share similar capabilities and solve comparable challenges
WhatsApp MCP Server
by lharries
Enables searching, reading, and sending personal WhatsApp messages and media through a Model Context Protocol (MCP) server, storing all data locally in SQLite and exposing controlled tools for LLMs like Claude.
RedNote MCP
by iFurySt
Provides authenticated access to XiaoHongShu (RedNote) notes, supporting keyword search, note retrieval by URL, and cookie persistence via a Model Context Protocol server.
Slack MCP Server
by korotovsky
Provides a powerful Model Context Protocol interface for Slack workspaces, enabling message retrieval, search, and optional posting via Stdio or SSE transports without requiring bot permissions.
Line Bot MCP Server
by line
Integrates the LINE Messaging API with a Model Context Protocol server, enabling AI agents to send text, flex, broadcast messages, retrieve user profiles, and manage rich menus on a LINE Official Account.
YouTube MCP Server
by ZubeidHendricks
Provides a standardized interface for interacting with YouTube content, enabling video retrieval, transcript access, channel and playlist management, and advanced analytics through the Model Context Protocol.
Mcp Teams Server
by InditexTech
Provides Microsoft Teams integration via the Model Context Protocol, enabling reading, creating, replying to messages and mentioning members.
Telegram MCP Server
by chigwell
Provides a full‑featured Telegram integration for MCP‑compatible clients, enabling programmatic access to chats, messages, contacts, profile management, and group administration.
Twitter MCP
by EnesCinr
Interact with Twitter to post tweets and search tweets programmatically via an MCP server.
Meta Ads MCP
by pipeboard-co
Provides a standardized interface for AI models to retrieve performance data, visualize creatives, and manage Meta advertising campaigns across Facebook, Instagram, and other Meta platforms.