MCP-Discord

Overview

• 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](#prerequisites)

• [Installation](#installation)

• [Configuration](#configuration)

• [Tools Documentation](#tools-documentation) - [Basic Functions](#basic-functions) - [Channel Management](#channel-management) - [Forum Functions](#forum-functions) - [Messages and Reactions](#messages-and-reactions) - [Webhook Management](#webhook-management)

• [Development](#development)

• [License](#license)

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](https://discord.com/developers/applications)) - 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

Manual Installation

Configuration

1. Environment variables:

1. Using the `--config` parameter when launching:

Usage with Claude/Cursor

• Claude ```json { "mcpServers": { "discord": { "command": "node", "args": [ "path/to/mcp-discord/build/index.js" ], "env": { "DISCORD_TOKEN": "your_discord_bot_token" } } } } ```

• Cursor ```json { "mcpServers": { "discord": { "command": "cmd", "args": [ "/c", "node", "path/to/mcp-discord/build/index.js" ], "env": { "DISCORD_TOKEN": "your_discord_bot_token" } } } } ```

Tools Documentation

Basic Functions

• `discord_login`: Login to Discord

• `discord_send`: Send a message to a specified channel

• `discord_get_server_info`: Get Discord server information

Channel Management

• `discord_create_text_channel`: Create a text channel

• `discord_delete_channel`: Delete a channel

Forum Functions

• `discord_get_forum_channels`: Get a list of forum channels

• `discord_create_forum_post`: Create a forum post

• `discord_get_forum_post`: Get a forum post

• `discord_reply_to_forum`: Reply to a forum post

• `discord_delete_forum_post`: Delete a forum post

Messages and Reactions

• `discord_read_messages`: Read channel messages

• `discord_add_reaction`: Add a reaction to a message

• `discord_add_multiple_reactions`: Add multiple reactions to a message

• `discord_remove_reaction`: Remove a reaction from a message

• `discord_delete_message`: Delete a specific message from a channel

Webhook Management

• `discord_create_webhook`: Creates a new webhook for a Discord channel

• `discord_send_webhook_message`: Sends a message to a Discord channel using a webhook

• `discord_edit_webhook`: Edits an existing webhook for a Discord channel

• `discord_delete_webhook`: Deletes an existing webhook for a Discord channel

Development

License