Discord Node MCP logo

Discord Node MCP

Controls Discord servers through a bot token, covering channels, messages, members, roles, moderation, and administration.

Install Discord Node MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "discord-node-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mahesvara/discord-mcpserver"
      ],
      "env": {
        "DISCORD_BOT_TOKEN": "YOUR_VALUE_HERE",
        "TRANSPORT": "YOUR_VALUE_HERE",
        "PORT": "YOUR_VALUE_HERE",
        "HOST": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 67 tools correctly ().

Overview

The discord-node-mcp MCP server connects an MCP client to Discord through a configured bot token. It exposes tools for managing servers, channels, messages, members, roles, permissions, moderation, webhooks, events, and community settings. Reach for it when an agent needs to inspect or change Discord resources through either stdio or HTTP transport.

Use cases

  • Inspect Discord guilds, channels, members, and roles
  • Create and organize channels, forums, and permissions
  • Send, retrieve, edit, moderate, and pin messages
  • Manage members, roles, bans, and timeouts
  • Configure onboarding, welcome screens, and auto moderation

Key features

  • Discord guild and channel administration
  • Message, reaction, and pin management
  • Member, role, and permission controls
  • Forum, onboarding, and community configuration
  • Webhook, invite, event, emoji, and sticker management
  • Stdio and HTTP transport modes

Tools67

What Discord Node MCP lets your agent do. Expand a tool for its parameters.

Verified live~18.1k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

17/19 checks healthy over the last 104d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 14h ago via OSV.dev · @mahesvara/discord-mcpserver (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads317Package downloads in the last 30 days.
Last commit9mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed67Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Discord Node MCP works

What the discord-node-mcp MCP server does

The discord-node-mcp MCP server gives MCP clients access to Discord administration and community-management operations through a bot account. It can inspect available guilds, channels, members, roles, permissions, messages, bans, audit logs, community settings, welcome screens, onboarding configuration, auto-moderation rules, emojis, stickers, invites, webhooks, and scheduled events.

The available operations also include changes to Discord resources. Agents can create, edit, delete, reorder, assign, remove, pin, unpin, react to, or otherwise manage supported objects, depending on the bot’s permissions. Member actions include kicking, banning, unbanning, nickname changes, voice-channel moves, and timeouts. Message editing is limited to messages sent by the bot.

How it works

The server authenticates to Discord with DISCORD_BOT_TOKEN and exposes its Discord operations as MCP tools. With HTTP enabled, the MCP endpoint is available at /mcp on the configured host and port.

Discord permissions determine which actions succeed. The bot must be invited with the scopes and permissions needed for the intended operations. Some functionality also depends on enabling Discord’s Server Members Intent and Message Content Intent in the Developer Portal.

Setup and configuration

Create a Discord application and bot in the Discord Developer Portal, copy its token, enable the required privileged intents, and invite the bot to the target server. The documented installation choices are a global npm package install or running the package through npx.

To run the discord-node-mcp MCP server, set DISCORD_BOT_TOKEN in the MCP client configuration or a .env file. TRANSPORT accepts stdio or http and defaults to stdio; PORT defaults to 3000, while HOST defaults to localhost. HTTP deployments can bind to 0.0.0.0 for remote access, but the material does not describe an authentication layer for that endpoint.

Stdio configurations invoke the installed command or npx; HTTP configurations use an MCP URL such as http://your-server-ip:3000/mcp.

Tools and capabilities

The tool groups cover:

  • Guild details, settings, membership, bans, pruning, and audit logs
  • Channel creation, editing, deletion, listing, forum tags, and permission overrides
  • Message retrieval and management, reactions, replies, and pins
  • Member, role, nickname, voice-channel, and timeout operations
  • Community settings, welcome screens, onboarding, and auto moderation
  • Emojis, stickers, invites, webhooks, and scheduled events

Forum-specific operations include forum channel creation, layout and sorting settings, default reaction configuration, and tag management. Community setup tools can configure rules, updates, and safety-alert channels, while onboarding tools can define prompts, default channels, and roles.

Limitations and notes

The bot’s Discord permissions and enabled gateway intents constrain the available functionality. Administrative actions such as bans, role changes, channel changes, webhook management, and event management require the corresponding Discord permissions. Keep the bot token secret; the setup instructions treat it as sensitive credential data.

Review the bot’s scope and permissions before enabling tools that can modify or remove Discord content.

Written by AllMCPs with AI assistance from the project’s README and listing data. How we build listings

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Discord Node MCP

discord-node-mcp is an MCP server that connects AI clients to Discord through a bot token. Its main tools manage guilds, channels, messages, members, roles, permissions, moderation, community settings, webhooks, invites, emojis, stickers, and scheduled events, using stdio by default or HTTP for remote access.

Install it globally with npm or run it through npx. The documented commands use the package name `@mahesvara/discord-mcpserver`; configure the resulting command in your MCP client and provide `DISCORD_BOT_TOKEN` as an environment variable.

Only `DISCORD_BOT_TOKEN` is required. `TRANSPORT` selects stdio or HTTP and defaults to stdio, while `PORT` defaults to 3000 and `HOST` defaults to localhost when HTTP transport is used.

Yes, the README provides a Claude Desktop configuration. You can run the server through the installed command or npx using stdio, then pass `DISCORD_BOT_TOKEN` in the client configuration.

The required permissions depend on the operations you plan to use. The setup guidance lists permissions for channels, messages, reactions, member management, server administration, emojis, stickers, webhooks, and events, and also requires the relevant privileged gateway intents.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewDiscord Node MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/discord-node-mcp?style=directory)](https://allmcps.com/mcp/discord-node-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/discord-node-mcp"><img src="https://allmcps.com/api/badge/discord-node-mcp?style=directory" alt="Discord Node MCP on AllMCPs" /></a>