Skip to content
MCP server

discord-mcp

Manage a Discord server from your AI client through your own bot, with 100 tools

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI, macOS, Windows
Runs
Locally
Version
2.4.0
Listing updated
2 days ago

About discord-mcp

discord-mcp is a free MCP server for communication. It runs locally on your machine and is started by your AI client.

The server connects an assistant to a Discord server through a bot you create, and the bot's Discord permissions are the ceiling on what it can do. The README describes 100 tools across messages, channels, permissions, members, roles, moderation, forums, webhooks, scheduled events, invites and DMs, with example asks such as summarising a busy channel, scheduling a community call or previewing a spam cleanup.

Because all 100 tools cost about 32k tokens of context, a DISCORD_MCP_TOOLSETS setting exposes only chosen groups; for example a chat profile with 25 tools is about 9k tokens. Read-only mode keeps just the 35 tools marked readOnlyHint. Bulk deletes, bulk bans, member prunes and channel deletion run as dry runs unless dry_run is false, and DISCORD_ALLOWED_GUILDS restricts calls to listed servers.

Setup needs a bot token, Server Members and Message Content intents, and Node.js 22 or later. It runs over stdio via npx, a Docker image or a Claude Desktop bundle, with one-click installs for VS Code and Cursor.

Install

Run in a terminal

claude mcp add discord-mcp --env DISCORD_TOKEN='<DISCORD_TOKEN>' --env DISCORD_MCP_HTTP_TOKEN='<DISCORD_MCP_HTTP_TOKEN>' -- npx -y @pasympa/discord-mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "discord-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@pasympa/discord-mcp"
      ],
      "env": {
        "DISCORD_TOKEN": "<DISCORD_TOKEN>",
        "DISCORD_MCP_HTTP_TOKEN": "<DISCORD_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • DISCORD_TOKENDiscord bot tokenRequired
  • DISCORD_MCP_TOOLSETSComma-separated toolsets to expose: discovery, messages, channels, permissions, members, roles, moderation, screening, stats, forums, webhooks, scheduled_events, invites, dm, or all. An unknown name stops the server at startup.
  • DISCORD_MCP_READ_ONLYSet to true to expose only the read-only tools of the selected toolsets: write tools are neither listed nor callable. Any value other than true/false, 1/0, yes/no or on/off stops the server at startup.
  • DISCORD_ALLOWED_GUILDSComma-separated guild IDs the server may act on. Calls that target any other guild are rejected. Unset allows every guild.
  • DISCORD_MESSAGE_CONTENTSet to false to stop requesting the Message Content privileged intent at connect time.
  • DISCORD_GUILD_MEMBERSSet to false to stop requesting the Server Members privileged intent at connect time.
  • DISCORD_MCP_TRANSPORTstdio, or http to serve Streamable HTTP on /mcp for remote clients such as the OpenAI Responses API, Codex or n8n. Any other value stops the server at startup.
  • DISCORD_MCP_HTTP_TOKENBearer token every HTTP request must carry. Required when DISCORD_MCP_TRANSPORT is http: at least 32 characters from the RFC 6750 b64token alphabet, different from DISCORD_TOKEN. Generate one with openssl rand -hex 32.
  • DISCORD_MCP_HTTP_HOSTAddress the HTTP server listens on when DISCORD_MCP_TRANSPORT is http. Keep 127.0.0.1 unless the server runs in a container.
  • DISCORD_MCP_HTTP_PORTPort the HTTP server listens on when DISCORD_MCP_TRANSPORT is http.
  • DISCORD_MCP_HTTP_ALLOWED_HOSTSComma-separated hostnames, without port, accepted in the Host header of HTTP requests besides localhost, 127.0.0.1 and [::1], such as the public name a reverse proxy forwards.
  • DISCORD_TOKENDiscord bot tokenRequired
  • DISCORD_MCP_TOOLSETSComma-separated toolsets to expose: discovery, messages, channels, permissions, members, roles, moderation, screening, stats, forums, webhooks, scheduled_events, invites, dm, or all. An unknown name stops the server at startup.
  • DISCORD_MCP_READ_ONLYSet to true to expose only the read-only tools of the selected toolsets: write tools are neither listed nor callable. Any value other than true/false, 1/0, yes/no or on/off stops the server at startup.
  • DISCORD_ALLOWED_GUILDSComma-separated guild IDs the server may act on. Calls that target any other guild are rejected. Unset allows every guild.
  • DISCORD_MESSAGE_CONTENTSet to false to stop requesting the Message Content privileged intent at connect time.
  • DISCORD_GUILD_MEMBERSSet to false to stop requesting the Server Members privileged intent at connect time.
  • DISCORD_MCP_TRANSPORTstdio, or http to serve Streamable HTTP on /mcp for remote clients such as the OpenAI Responses API, Codex or n8n. Any other value stops the server at startup.
  • DISCORD_MCP_HTTP_TOKENBearer token every HTTP request must carry. Required when DISCORD_MCP_TRANSPORT is http: at least 32 characters from the RFC 6750 b64token alphabet, different from DISCORD_TOKEN. Generate one with openssl rand -hex 32.
  • DISCORD_MCP_HTTP_HOSTAddress the HTTP server listens on when DISCORD_MCP_TRANSPORT is http. Keep 127.0.0.1 unless the server runs in a container.
  • DISCORD_MCP_HTTP_PORTPort the HTTP server listens on when DISCORD_MCP_TRANSPORT is http.
  • DISCORD_MCP_HTTP_ALLOWED_HOSTSComma-separated hostnames, without port, accepted in the Host header of HTTP requests besides localhost, 127.0.0.1 and [::1], such as the public name a reverse proxy forwards.

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

discord_bulk_delete_messages
Bulk-deletes messages; dry run by default.
discord_bulk_ban
Bans several members; dry run by default.
discord_prune_members
Prunes inactive members; dry run by default.
discord_delete_channel
Deletes a channel; dry run by default.
discord_list_webhooks
Lists webhooks, including their tokens.
discord_read_dms
Reads the bot's direct messages with a user.

What it does

100 tools
Messages, roles, channels, forums, events, webhooks, invites and moderation.
Toolset selection
Load only the tool groups you need to save context.
Dry runs
Destructive bulk actions preview by default.
Guild allowlist
Restrict every call to chosen Discord servers.
Read-only mode
Expose only tools marked as read-only.
Tool annotations
Reads and destructive writes are flagged so clients can ask first.

Good for

  • Summarise a busy channel and post a recap
  • Preview and remove a spam raid
  • Schedule an event and announce it
  • Audit permission overwrites across the server
  • Create an expiring invite for new members

Pricing

Free

Free to run with your own Discord bot.

discord-mcp FAQ

What can it do on my server?

Only what the bot's Discord permissions allow.

How do I cut the context cost?

Set DISCORD_MCP_TOOLSETS to the groups you need; the README shows a 25-tool profile at about 9k tokens.

Are destructive actions safe?

Bulk delete, bulk ban, prune and channel deletion run as dry runs unless dry_run is set to false.

What do I need installed?

Node.js 22 or later, or Docker, plus a bot token.

Is discord-mcp free?

Yes. discord-mcp is free to use.

How do I add discord-mcp to Claude Code?

Run this command in your terminal: claude mcp add discord-mcp --env DISCORD_TOKEN='<DISCORD_TOKEN>' --env DISCORD_MCP_HTTP_TOKEN='<DISCORD_MCP_HTTP_TOKEN>' -- npx -y @pasympa/discord-mcp

What are the best alternatives to discord-mcp?

The closest alternatives to discord-mcp are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

Alternatives to discord-mcp

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity