discordmcp

WHAT IT CONNECTS

What discordmcp gives an AI Agent

• 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
• 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
• Clone this repository:
• Install dependencies:
• Create a `.env` file in the root directory with your Discord bot token:
• Build the server:
• Open your Claude for Desktop configuration file:
• macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
• Windows: `%APPDATA%\Claude\claude_desktop_config.json`
• Add the Discord MCP server configuration:
• Restart Claude for Desktop
• `server` (optional): Server name or ID (required if bot is in multiple servers)
• `channel`: Channel name (e.g., "general") or ID
• `message`: Message content to send
• `server` (optional): Server name or ID (required if bot is in multiple servers)
• `channel`: Channel name (e.g., "general") or ID
• `limit` (optional): Number of messages to fetch (default: 50, max: 100)
• Install development dependencies:
• Start the server in development mode:
• "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?"
• 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
• 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
• Check the GitHub Issues section
• Consult the MCP documentation at https://modelcontextprotocol.io
• Open a new issue with detailed reproduction steps