Skip to main content
Glama

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 (using either channel IDs or channel names)

  • Retrieve forum channel lists

  • Create/delete/reply to forum posts

  • Create/delete text channels

  • Add/remove message reactions

  • Create/edit/delete/use webhooks

Related MCP server: MCP-Discord

Table of Contents

Prerequisites

Note:
According to Discord's security model, a bot can only access information from servers it has been explicitly added to.
If you want to use this MCP server to access a specific Discord server, you must add the bot to that server first.
Use the invite link below to add the bot to your target server.

Installation

Installing via Smithery

To install mcp-discord automatically via Smithery

Manual Installation

# Clone the repository
git clone https://github.com/barryyip0625/mcp-discord.git
cd mcp-discord

# Install dependencies
npm install

# Compile TypeScript
npm run build

Configuration

A Discord bot token is required for proper operation. The server supports two transport methods: stdio and streamable HTTP.

Transport Methods

  1. stdio (Default)

    • Traditional stdio transport for basic usage

    • Suitable for simple integrations

  2. streamable HTTP

    • HTTP-based transport for more advanced scenarios

    • Supports stateless operation

    • Configurable port number

Configuration Options

You can provide configuration in two ways:

  1. Environment variables:

DISCORD_TOKEN=your_discord_bot_token
  1. Using command line arguments:

# For stdio transport (default)
node build/index.js --config "your_discord_bot_token"

# For streamable HTTP transport
node build/index.js --transport http --port 3000 --config "your_discord_bot_token"

Usage with Claude/Cursor

Claude

  1. Using stdio transport:

{
    "mcpServers": {
        "discord": {
            "command": "node",
            "args": [
                "path/to/mcp-discord/build/index.js",
                "--config",
                "your_discord_bot_token"
            ]
        }
    }
}
  1. Using streamable HTTP transport:

{
    "mcpServers": {
        "discord": {
            "command": "node",
            "args": [
                "path/to/mcp-discord/build/index.js",
                "--transport",
                "http",
                "--port",
                "3000",
                "--config",
                "your_discord_bot_token"
            ]
        }
    }
}

Cursor

  1. Using stdio transport:

{
    "mcpServers": {
        "discord": {
            "command": "cmd",
            "args": [
                "/c",
                "node",
                "path/to/mcp-discord/build/index.js",
                "--config",
                "your_discord_bot_token"
            ]
        }
    }
}
  1. Using streamable HTTP transport:

{
    "mcpServers": {
        "discord": {
            "command": "cmd",
            "args": [
                "/c",
                "node",
                "path/to/mcp-discord/build/index.js",
                "--transport",
                "http",
                "--port",
                "3000",
                "--config",
                "your_discord_bot_token"
            ]
        }
    }
}

Tools Documentation

Basic Functions

  • discord_login: Login to Discord

  • discord_send: Send a message to a specified channel (supports both channel ID and channel name)

  • 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

# Development mode
npm run dev

License

MIT License

Available Tools

22 tools
discord_add_multiple_reactionsB

Adds multiple emoji reactions to a Discord message at once

Inputs: channelId (required), messageId (required), emojis (required).

discord_add_reactionC

Adds an emoji reaction to a specific Discord message

Inputs: channelId (required), messageId (required), emoji (required).

discord_create_categoryC

Creates a new category in a Discord server.

Inputs: guildId (required), name (required), position, reason.

discord_create_forum_postB

Creates a new post in a Discord forum channel with optional tags

Inputs: forumChannelId (required), title (required), content (required), tags.

discord_create_text_channelB

Creates a new text channel in a Discord server with an optional topic

Inputs: guildId (required), channelName (required), topic.

discord_create_webhookC

Creates a new webhook for a Discord channel

Inputs: channelId (required), name (required), avatar, reason.

discord_delete_categoryB

Deletes a Discord category by ID.

Inputs: categoryId (required), reason.

discord_delete_channelB

Deletes a Discord channel with an optional reason

Inputs: channelId (required), reason.

discord_delete_forum_postC

Deletes a forum post or thread with an optional reason

Inputs: threadId (required), reason.

discord_delete_messageB

Deletes a specific message from a Discord text channel

Inputs: channelId (required), messageId (required), reason.

discord_delete_webhookC

Deletes an existing webhook for a Discord channel

Inputs: webhookId (required), webhookToken, reason.

discord_edit_categoryB

Edits an existing Discord category (name and position).

Inputs: categoryId (required), name, position, reason.

discord_edit_webhookC

Edits an existing webhook for a Discord channel

Inputs: webhookId (required), webhookToken, name, avatar, +2 more.

discord_get_forum_channelsA

Lists all forum channels in a specified Discord server (guild)

Inputs: guildId (required).

discord_get_forum_postB

Retrieves details about a forum post including its messages

Inputs: threadId (required).

discord_get_server_infoB

Retrieves detailed information about a Discord server including channels and member count

Inputs: guildId (required).

discord_loginB

Logs in to Discord using the configured token

Inputs: token.

discord_read_messagesA

Retrieves messages from a Discord text channel with a configurable limit

Inputs: channelId (required), limit.

discord_remove_reactionB

Removes a specific emoji reaction from a Discord message

Inputs: channelId (required), messageId (required), emoji (required), userId.

discord_reply_to_forumB

Adds a reply to an existing forum post or thread

Inputs: threadId (required), message (required).

discord_sendC

Sends a message to a specified Discord text channel

Inputs: channelId (required), message (required).

discord_send_webhook_messageB

Sends a message to a Discord channel using a webhook

Inputs: webhookId (required), webhookToken (required), content (required), username, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 22 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose targeting specific Discord resources and actions, such as discord_add_reaction vs discord_remove_reaction for reactions, discord_create_text_channel vs discord_delete_channel for channels, and discord_send vs discord_send_webhook_message for messaging. There is no overlap or ambiguity in functionality, making tool selection straightforward for an agent.

    Naming Consistency5/5

    All tool names follow a consistent snake_case pattern with a 'discord_' prefix and a clear verb_noun structure, such as discord_create_category, discord_delete_message, and discord_get_server_info. This uniformity enhances readability and predictability across the entire tool set.

    Tool Count3/5

    With 22 tools, the count is borderline high for a Discord server, as it covers many specific operations like reactions, channels, webhooks, and forum posts. While comprehensive, it may feel heavy compared to more focused servers, but it aligns reasonably with Discord's broad API scope.

    Completeness4/5

    The tool set provides extensive coverage of Discord's core features, including CRUD operations for channels, categories, webhooks, messages, reactions, and forum posts. Minor gaps exist, such as missing tools for editing messages or managing server roles, but agents can handle most workflows effectively with the available tools.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to interact with Discord through a bot, supporting server and member inspection, channel and role management, message and reaction handling, forum operations, and webhook administration.
      1,578 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to operate a Discord bot and manage Discord servers, channels, forums, messages, reactions, webhooks, roles, and members.
      1,578 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to interact with Discord by managing servers, channels, roles, members, messages, forum posts, reactions, and webhooks through a Discord bot.
      1,578 npm
      MIT