Skip to main content
Glama
Discord MCP Server

Discord MCP Server

by swarit-soni

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_me

Get profile information and status of the authenticated bot user.

list_guilds

List all Discord servers (guilds) the bot is a member of.

get_guild

Get details of a guild (members, roles, channels, emojis).

list_channels

List all channels in a guild.

get_channel

Get details of a specific channel or thread.

list_messages

Retrieve recent messages from a channel (supports limit, before, after, around).

get_message

Retrieve a single message by channel ID and message ID.

send_message

Send text messages, replies (reply_to_message_id), or rich embeds to a channel.

edit_message

Edit messages sent by the bot.

delete_message

Delete a message in a channel.

add_reaction

Add emoji reactions to messages.

delete_reaction

Remove bot reactions from messages.

list_members

List members of a guild.

get_pinned_messages

List all pinned messages in a channel.

pin_message

Pin a message in a channel.

unpin_message

Unpin a message in a channel.

create_thread

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-server

Set 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

MIT License

Available Tools

17 tools
add_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

    A3.7/5.0

    Scored across 17 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to interact with the Discord platform by managing servers, channels, roles, members, messages, forum posts, reactions, and webhooks.
      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 interact with the Discord platform, including managing servers, channels, messages, forums, roles, members, reactions, and webhooks.
      1,578 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to interact with Discord servers, channels, roles, members, messages, reactions, forum posts, and webhooks.
      1,578 npm
      MIT