Discord MCP Server

A lightweight, multi-guild Discord MCP server with 95+ tools

Local serverstdioTypeScript

What is the Discord MCP Server?

A lightweight, multi-guild Discord MCP server with 95+ tools

The short version

Manage your entire Discord server from Claude Desktop, Claude Code, Cursor, VS Code Copilot, or any MCP-compatible client. Messages, channels, roles, permissions, moderation, forums, webhooks — all through natural language.

  • 95+ tools — — messages, channels, roles, permissions, moderation, forums, webhooks, scheduled events, invites, DMs, embeds, and more
  • Multi-guild — — works across multiple servers, no GUILD_ID lock-in
  • Lightweight — — TypeScript + Node.js, ~70kB package, ~73MB Docker image (vs 400MB+ for Java alternatives)
  • Modular — — clean architecture, easy to extend with new tools
  • Two install methods — — npm or Docker, your choice

The tools it exposes

The server publishes 14 tools. What each one is for:

  • discord_list_guilds — List all servers the bot is connected to
  • discord_get_guild_info — Get detailed guild info (name, members, channels, roles, boosts)
  • discord_list_channels — List all channels in a guild grouped by category
  • discord_find_channel_by_name — Find a channel by name (partial match)
  • discord_read_messages — Read the last N messages from a text channel
  • discord_send_message — Send a plain text message
  • discord_reply_message — Reply to a specific message
  • discord_edit_message — Edit a message sent by the bot
  • discord_delete_message — Delete a specific message
  • discord_add_reaction — Add a reaction emoji to a message
  • discord_remove_reactions — Remove reactions (all, by emoji, or by user)
  • discord_get_reactions — List users who reacted with a specific emoji

Recorded tools

  • discord_list_guilds — List all servers the bot is connected to
  • discord_get_guild_info — Get detailed guild info (name, members, channels, roles, boosts)
  • discord_list_channels — List all channels in a guild grouped by category
  • discord_find_channel_by_name — Find a channel by name (partial match)
  • discord_read_messages — Read the last N messages from a text channel
  • discord_send_message — Send a plain text message
  • discord_reply_message — Reply to a specific message
  • discord_edit_message — Edit a message sent by the bot
  • discord_delete_message — Delete a specific message
  • discord_add_reaction — Add a reaction emoji to a message
  • discord_remove_reactions — Remove reactions (all, by emoji, or by user)
  • discord_get_reactions — List users who reacted with a specific emoji
  • discord_create_thread — Create a thread from a message or standalone
  • discord_bulk_delete_messages — Delete multiple messages at once (2-100)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
discord_list_guildsList all servers the bot is connected to
discord_get_guild_infoGet detailed guild info (name, members, channels, roles, boosts)
discord_list_channelsList all channels in a guild grouped by category
discord_find_channel_by_nameFind a channel by name (partial match)
discord_read_messagesRead the last N messages from a text channel
discord_send_messageSend a plain text message
discord_reply_messageReply to a specific message
discord_edit_messageEdit a message sent by the bot
discord_delete_messageDelete a specific message
discord_add_reactionAdd a reaction emoji to a message
discord_remove_reactionsRemove reactions (all, by emoji, or by user)
discord_get_reactionsList users who reacted with a specific emoji
discord_create_threadCreate a thread from a message or standalone
discord_bulk_delete_messagesDelete multiple messages at once (2-100)

How to install the Discord MCP Server

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@pasympa/discord-mcp"],
      "env": {
        "DISCORD_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
DISCORD_TOKENCredential the server authenticates with.Yes
GUILD_IDConfiguration value read at startup.Optional

Example prompts to try

  • “Use Discord to discord list guilds.”
  • “Use Discord to discord get guild info.”
  • “Use Discord to discord list channels.”

Frequently asked questions

A lightweight, multi-guild Discord MCP server with 95+ tools Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.