MCP-Discord enables AI assistants to interact with Discord through a comprehensive API. With this server, you can:
- Login & Authentication: Log in to Discord using a bot token
- Server Management: List available servers (guilds) and retrieve server details including channels and member count
- Channel Operations: Create, delete, and manage text channels
- Messaging: Send, read, and delete messages from channels
- Reactions: Add, remove, and manage multiple reactions to messages
- Forum Interactions: Get forum channels, create/delete posts, and reply to forum threads
- Webhook Management: Create, edit, delete webhooks and send messages through them
Enables AI assistants to interact with Discord, including logging in as a bot, managing servers and channels, sending/reading/deleting messages, creating and managing forum posts, adding reactions to messages, and creating/managing webhooks.
MCP-Discord
A Discord MCP (Model Context Protocol) server that enables AI assistants to interact with the Discord platform.
Overview
MCP-Discord provides the following Discord-related functionalities:
- Login to Discord bot
- Get server information
- Read/delete channel messages
- Send messages to specified channels
- Retrieve forum channel lists
- Create/delete/reply to forum posts
- Create/delete text channels
- Add/remove message reactions
- Create/edit/delete/use webhooks
Table of Contents
Prerequisites
- Node.js (v16.0.0 or higher)
- npm (v7.0.0 or higher)
- A Discord bot with appropriate permissions
- Bot token (obtainable from the Discord Developer Portal)
- Message Content Intent enabled
- Server Members Intent enabled
- Presence Intent enabled
- Permissions in your Discord server:
- Send Messages
- Create Public Threads
- Send Messages in Threads
- Manage Threads
- Manage Channels
- Add Reactions
Installation
Installing via Smithery
To install mcp-discord for Claude Desktop automatically via Smithery:
Manual Installation
Configuration
A Discord bot token is required for proper operation. You can provide it in two ways:
- Environment variables:
- Using the
--config
parameter when launching:
Enhanced Startup Script
The project includes an enhanced startup script (start-discord.js
) that provides better debugging and error handling:
- Loads environment variables from the .env file
- Sets default server and channel IDs if not provided
- Redirects console.log to stderr to avoid JSON parsing issues in Claude Desktop
- Tests the Discord connection directly before starting the MCP server
- Provides detailed error information if anything goes wrong
To use this script:
Usage with Claude/Cursor
- Claude
- Cursor
Tools Documentation
Basic Functions
discord_login
: Login to Discorddiscord_list_guilds
: List all available Discord servers (guilds) with their channelsdiscord_send
: Send a message to a specified channeldiscord_get_server_info
: Get Discord server information
Channel Management
discord_create_text_channel
: Create a text channeldiscord_delete_channel
: Delete a channel
Forum Functions
discord_get_forum_channels
: Get a list of forum channelsdiscord_create_forum_post
: Create a forum postdiscord_get_forum_post
: Get a forum postdiscord_reply_to_forum
: Reply to a forum postdiscord_delete_forum_post
: Delete a forum post
Messages and Reactions
discord_read_messages
: Read channel messagesdiscord_add_reaction
: Add a reaction to a messagediscord_add_multiple_reactions
: Add multiple reactions to a messagediscord_remove_reaction
: Remove a reaction from a messagediscord_delete_message
: Delete a specific message from a channel
Webhook Management
discord_create_webhook
: Creates a new webhook for a Discord channeldiscord_send_webhook_message
: Sends a message to a Discord channel using a webhookdiscord_edit_webhook
: Edits an existing webhook for a Discord channeldiscord_delete_webhook
: Deletes an existing webhook for a Discord channel
Development
License
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
A Discord MCP server that enables AI assistants to interact with Discord platforms, providing functionalities like sending messages, managing channels, creating forum posts, and handling webhooks.
- Overview
- Table of Contents
- Prerequisites
- Installation
- Configuration
- Usage with Claude/Cursor
- Tools Documentation
- Development
- License
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityAn MCP server that enables posting messages to Discord webhooks, allowing customization of content, username, and avatar URL.Last updated -10JavaScriptMIT License
- AsecurityAlicenseAqualityA Discord Model Context Protocol server that enables AI assistants to interact with Discord, providing functionality for sending messages, managing channels, handling forum posts, and working with reactions.Last updated -152632TypeScriptMIT License
- AsecurityFlicenseAqualityAn MCP server that allows Claude to interact with Discord by providing tools for sending/reading messages and managing server resources through Discord's API.Last updated -1938JavaScript
- -securityFlicense-qualityA Discord bot server that integrates with Mastra's MCP Bot component to provide intelligent assistance and answer questions about Mastra.ai through direct messages and slash commands.Last updated -731TypeScript