Discord MCP Server
Allows Claude to interact with Discord servers through various tools for sending messages, reading message history, listing channels and servers, and retrieving user information.
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 Server send a message to #general saying 'Meeting starts in 5 minutes'"
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 Server
An MCP (Model Context Protocol) server for Discord API integration with Claude. This server allows Claude to interact with Discord servers via tools that perform actions such as sending messages, reading messages, and managing server resources.
Prerequisites
Node.js 16 or higher
A Discord bot token (create one at the Discord Developer Portal)
Appropriate bot permissions:
Read Messages/View Channels
Send Messages
Read Message History
(Optional) Manage Roles, Manage Channels, etc. depending on functionality needed
Related MCP server: Discord Bridge MCP Server
Installation
Clone this repository
Install dependencies:
npm installBuild the project:
npm run build
Configuration
Create a .env file in the root directory with:
DISCORD_TOKEN=your_discord_bot_token_hereUsage
Start the server:
npm startConfigure Claude Desktop:
Add to Claude Desktop's configuration file:
{ "mcpServers": { "discord": { "command": "node", "args": ["path/to/discord-mcp/build/index.js"], "env": { "DISCORD_TOKEN": "your_discord_bot_token_here" } } } }
Available Tools
send-message: Send a message to a Discord channelread-messages: Read recent messages from a Discord channellist-channels: List available channels in the serverlist-servers: List servers the bot has access toget-user-info: Get information about a specific user
Security Considerations
The Discord bot token grants access to your Discord bot. Keep it secure.
The bot can only access servers it has been invited to.
Actions are limited by the bot's permissions in each server.
License
MIT
Available Tools
19 toolsdiscord_add_friendB
Send a friend request to a user
Inputs: no named parameters.
discord_add_reactionC
Add a reaction to a message
Inputs: channelId (required), messageId (required), emoji (required).
discord_cleanup_downloadC
Clean up a previously downloaded Discord attachment file
Inputs: path (required).
discord_clear_presenceB
Clear your Discord presence/activity
Inputs: no named parameters.
discord_create_dmC
Create or get existing DM channel with a user
Inputs: userId (required).
discord_delete_messageC
Delete a message
Inputs: channelId (required), messageId (required).
discord_download_attachmentB
Download a Discord attachment and return it as MCP file reference
Inputs: url (required).
discord_edit_messageC
Edit a previously sent message
Inputs: channelId (required), messageId (required), content (required).
discord_get_channelB
Get information about a Discord channel
Inputs: channelId (required).
discord_get_dm_channelsB
Get list of DM channels for the current user
Inputs: no named parameters.
discord_get_friendsB
Get list of friends for the current user
Inputs: no named parameters.
discord_get_messageB
Get a specific message by ID with full attachment details
Inputs: channelId (required), messageId (required).
discord_get_message_historyC
Get message history from a Discord channel with optional filtering
Inputs: channelId (required), limit, before, after, +1 more.
discord_list_attachmentsC
List all attachments in a Discord channel from recent messages
Inputs: channelId (required), limit, imageOnly, minSize, +1 more.
discord_remove_friendC
Remove a friend or cancel a friend request
Inputs: userId (required).
discord_remove_reactionC
Remove a reaction from a message
Inputs: channelId (required), messageId (required), emoji (required), userId.
discord_search_messagesC
Search for messages in a Discord channel with text query and filters
Inputs: channelId (required), query (required), limit, authorId, +5 more.
discord_send_messageC
Send a message to a Discord channel, optionally with up to 10 files
Inputs: channelId (required), content, files, tts, +1 more.
discord_update_presenceB
Update your Discord presence/status
Inputs: status, activity, afk.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 19 tools
Every tool has a clearly distinct purpose with no ambiguity. Tools are well-defined by their specific actions (e.g., add_friend vs. remove_friend, send_message vs. edit_message vs. delete_message), and even similar-sounding tools like get_message and get_message_history serve different functions (single message retrieval vs. channel history).
All tool names follow a consistent verb_noun pattern prefixed with 'discord_', such as discord_send_message, discord_get_channel, and discord_remove_reaction. This uniformity makes the tool set predictable and easy to navigate, with no deviations in naming conventions.
With 19 tools, the count is slightly high but reasonable for a comprehensive Discord integration. It covers a wide range of functionalities from messaging and reactions to friend management and presence updates, though it might be borderline for some use cases, leaning toward a heavier but well-justified set.
The tool set provides complete coverage for Discord interactions, including CRUD operations for messages (send, edit, delete, get), friend management (add, remove, list), channel handling (get, create DM, list DMs), and auxiliary functions like reactions, attachments, and presence. No obvious gaps are present, supporting full agent workflows.
Related MCP Connectors
An MCP server that integrates with Discord to provide AI-powered features.
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
- Discortics - Discord BotDeprecatedcom.discortics
Set up and manage your Discord server from MCP: channels, roles, verification, tickets and security.
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server for interacting with Discord.1913MIT
- AlicenseAqualityCmaintenanceAn MCP server that provides native Discord tools for Claude Code, enabling bidirectional communication with remote agents or humans via the Discord REST API. It allows users to send messages, read channel history, and manage reactions directly from their local environment.63MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that enables Claude Desktop to interact with Discord through a dedicated bot. It allows users to list channels, read message history, and send messages directly from the AI interface.2-
- AlicenseAqualityDmaintenanceAn MCP server providing 26 tools for Discord API interactions, enabling message management, moderation, channel operations, and server inspection through Claude Code, Paperclip agents, or other MCP-compatible clients.26MIT