Skip to main content
Glama
Discord MCP Server

Discord MCP Server

by RossH121

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

  1. Clone this repository

  2. Install dependencies:

    npm install
  3. Build the project:

    npm run build

Configuration

Create a .env file in the root directory with:

DISCORD_TOKEN=your_discord_bot_token_here

Usage

  1. Start the server:

    npm start
  2. Configure 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 channel

  • read-messages: Read recent messages from a Discord channel

  • list-channels: List available channels in the server

  • list-servers: List servers the bot has access to

  • get-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 tools
discord_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

    A3.5/5.0

    Scored across 19 tools

    Disambiguation5/5

    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).

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness5/5

    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

    Related MCP Servers