Enables asynchronous communication between AI agents and users via Discord, allowing agents to send notifications and request user input during long-running tasks.
Click on "Install 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., "@MCP Discord Agent Communicationask me on Discord for approval before starting the server migration"
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.
MCP Discord Agent Communication
An MCP (Model Context Protocol) server that enables async communication between AI agents and users via Discord. Perfect for long-running AI tasks where you need remote interaction capabilities.
🎯 Purpose
This isn't a full Discord bot - it's specifically designed for AI agents to communicate with users remotely during long-running tasks. Step away from your machine while your AI assistant handles complex work and reaches out when needed.
Features
💬 Unified Communication - Single tool for all Discord interactions
📢 Send Notifications - Agent sends updates without waiting for response
🔄 Request User Input - Agent asks questions and waits for replies
⏰ Async Communication - Perfect for long-running tasks requiring remote interaction
Use Cases
Perfect for scenarios where AI agents need remote human interaction:
Kick off complex tasks and get notified when they complete
Let AI ask for your input or feedback when decisions are needed
Stay in the loop while doing other activities (workouts, walks, meetings)
Monitor progress without being glued to your screen
Quick Setup
1. Create Discord Bot
Go to Discord Developer Portal
Create "New Application" → Go to "Bot" → "Add Bot"
Copy the bot token
Enable "MESSAGE CONTENT INTENT" in bot settings
Use OAuth2 URL Generator to invite bot to your server with these permissions:
Send Messages, Read Message History, Add Reactions, View Channels
2. Get Channel ID
Enable Developer Mode in Discord settings, then right-click your channel → "Copy Channel ID"
3. Configure Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
Available Tool
discord_message
Send a message to Discord, optionally waiting for a response.
Simple notification (no response needed):
Request user input (waits for reply):
Yes/No or any other question (waits for reply):
Note: When expect_reply is true, the tool waits for the user to reply to the message in Discord.
Agent Instructions
For guidance on how to instruct AI agents to use these tools effectively, see AGENT_INSTRUCTIONS.md. It provides example guidelines for when agents should communicate vs. work autonomously.
Important Notes
Discord Notifications
Only one device receives Discord notifications - disable Discord on other devices or turn off notifications if you want them on a specific device
Notifications work best on mobile devices when other instances are closed
How It Works
Notifications: Direct message to channel (when
expect_replyis false or omitted)Input requests: Users reply to the bot's message using Discord's reply feature (when
expect_replyis true)Default timeout: 300 seconds (5 minutes) when waiting for replies
Troubleshooting
Bot offline: Check token and permissions
No notifications: Ensure MESSAGE CONTENT INTENT enabled, check channel permissions
Timeouts: Users must reply to messages (not just type in channel) or click reactions
Development
License
MIT
Publishing Status
Install globally: npm install -g mcp-discord-agent-comm