Discord MCP Server
Provides tools for interacting with Discord, including sending and managing messages, reading channel history, managing guilds and channels, creating threads, managing pinned messages, and adding or removing reactions.
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 we'll start the standup in 10 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 ๐ค๐ฌ
A lightweight, zero-external-dependency Model Context Protocol (MCP) server for interacting with Discord through AI assistants like Google Antigravity, Claude Desktop, Cursor, and other MCP-compliant clients.
โจ Features
๐ฌ Messages: Read recent chat history, send messages, reply to threads/messages, edit and delete messages.
๐ข Servers & Guilds: List servers the bot belongs to, inspect member lists, roles, and guild details.
๐ Channels & Categories: Inspect channels, channel topics, and message metadata.
๐งต Threads: Create and participate in channel threads.
๐ Pins: Read, add, and remove pinned messages.
๐ Reactions: Add and remove reactions with unicode and custom emojis.
๐ Zero External Dependencies: Built entirely with Python's standard library (
urllib,json).
Related MCP server: MCP-Discord
๐ ๏ธ Tool Reference
Tool | Description |
| Get profile information and status of the authenticated bot user. |
| List all Discord servers (guilds) the bot is a member of. |
| Get details of a guild (members, roles, channels, emojis). |
| List all channels in a guild. |
| Get details of a specific channel or thread. |
| Retrieve recent messages from a channel (supports |
| Retrieve a single message by channel ID and message ID. |
| Send text messages, replies ( |
| Edit messages sent by the bot. |
| Delete a message in a channel. |
| Add emoji reactions to messages. |
| Remove bot reactions from messages. |
| List members of a guild. |
| List all pinned messages in a channel. |
| Pin a message in a channel. |
| Unpin a message in a channel. |
| Create a new thread in a channel or from an existing message. |
๐ Quickstart & Configuration
1. Prerequisites
Python 3.10+
A Discord Bot Token (obtain one from the Discord Developer Portal).
Ensure your bot has appropriate permissions (e.g. Read Messages/View Channels, Send Messages, Read Message History, Add Reactions, etc.).
2. Installation & Running
Clone the repository:
git clone https://github.com/swaritsoni6-lgtm/discord-mcp-server.git
cd discord-mcp-serverSet your token and run:
export DISCORD_BOT_TOKEN="your-bot-token-here"
python3 server.pyโ๏ธ Client Configurations
Antigravity / Gemini CLI (~/.gemini/config/mcp_config.json)
{
"mcpServers": {
"discord": {
"command": "python3",
"args": ["/path/to/discord-mcp-server/server.py"],
"env": {
"DISCORD_BOT_TOKEN": "your-bot-token-here"
}
}
}
}Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"discord": {
"command": "python3",
"args": ["/path/to/discord-mcp-server/server.py"],
"env": {
"DISCORD_BOT_TOKEN": "your-bot-token-here"
}
}
}
}๐ License
Available Tools
17 toolsadd_reactionA
Adds a reaction emoji to a message in a Discord channel.
Inputs: emoji (required), channel_id (required), message_id (required).
create_threadA
Creates a new public thread in a Discord channel or from a message.
Inputs: name (required), channel_id (required), message_id, auto_archive_duration.
delete_messageB
Deletes a message in a Discord channel.
Inputs: channel_id (required), message_id (required).
delete_reactionB
Deletes the bot's reaction on a message in a Discord channel.
Inputs: emoji (required), channel_id (required), message_id (required).
edit_messageB
Edits a previously sent message by the bot in a Discord channel.
Inputs: channel_id (required), message_id (required), embeds, content.
get_channelA
Gets details of a specific Discord channel or thread by its ID.
Inputs: channel_id (required).
get_guildA
Gets details of a specific Discord guild (server) by its ID, including roles, emojis, and member count.
Inputs: guild_id (required), with_counts.
get_meA
Gets information about the current authenticated Discord bot user.
Inputs: no named parameters.
get_messageA
Retrieves a specific message by channel ID and message ID.
Inputs: channel_id (required), message_id (required).
get_pinned_messagesA
Gets all pinned messages in a Discord channel.
Inputs: channel_id (required).
list_channelsA
Lists all channels in a specific Discord guild/server.
Inputs: guild_id (required).
list_guildsA
Lists all Discord guilds (servers) the bot is currently a member of.
Inputs: after, limit, before.
list_membersB
Lists members of a Discord guild/server.
Inputs: guild_id (required), after, limit.
list_messagesB
Fetches recent messages from a Discord channel or thread.
Inputs: channel_id (required), after, limit, around, +1 more.
pin_messageA
Pins a message in a Discord channel.
Inputs: channel_id (required), message_id (required).
send_messageA
Sends a message to a specified Discord text channel or thread.
Inputs: channel_id (required), tts, embeds, content, +1 more.
unpin_messageB
Unpins a message in a Discord channel.
Inputs: channel_id (required), message_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
TDQS
Scored across 17 tools
Each tool targets a distinct resource-action pair: guild, channel, message, reaction, pin, or thread. Even similar tools like list_messages and get_message are clearly differentiated by scope, so an agent should not confuse them.
All tools follow a consistent snake_case verb_noun pattern, such as get_, list_, send_, edit_, delete_, add_, pin_, and create_. The naming is uniform and predictable across the entire set.
At 17 tools, the server is slightly above the ideal 3-15 tool range but each tool maps to a concrete Discord API operation and earns its place. The count is heavy but still navigable and well-scoped for a Discord bot.
The set covers core Discord workflows well: guild/channel reads, full message CRUD, reactions, pins, and thread creation. Obvious gaps like channel creation/deletion, member management, and thread editing/deleting are notable but not critical for the primary message-interaction use case.
Related MCP Connectors
Connect assistants to your workspace knowledge, skills, and work tools.
Carbon Voice MCP serves as a bridge that connects AI assistants like ChatGPT, Claude, and Cursor to a user's Carbon Voice account, turning voice messages and conversations into a private, on-demand knowledge base. It provides 28 specialized tools for comprehensive voice messaging management, including creating and sending messages, accessing conversation history with instant transcription, running AI actions (summarization, TLDR generation, meeting notes), and managing workspace collaboration through folders, contacts, and team communications.
Messaging tools for AI agents: send messages, manage chats, groups and channels.
Read, summarize and send your own WhatsApp messages from AI assistants (OAuth 2.1).
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to interact with the Discord platform by managing servers, channels, roles, members, messages, forum posts, reactions, and webhooks.1,578 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to interact with the Discord platform by managing servers, channels, roles, forum posts, messages, reactions, and webhooks through a Discord bot.1,578 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to interact with the Discord platform, including managing servers, channels, messages, forums, roles, members, reactions, and webhooks.1,578 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to interact with Discord servers, channels, roles, members, messages, reactions, forum posts, and webhooks.1,578 npmMIT