Home › Communication › pasympa/discord-mcp

pasympa/discord-mcp

Run your Discord from Claude, Codex, Cursor or VS Code: messages, moderation, roles, forums, events

TypeScript Local macOSWindowsLinux
★ 38 stars Last pushed 2026-11-19 License: MIT

Topics: Communication

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (npm 2.4.0)

npx -y @pasympa/discord-mcp@2.4.0

Or add to your MCP client config:

{
  "mcpServers": {
    "discord-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pasympa/discord-mcp@2.4.0"
      ],
      "env": {
        "DISCORD_TOKEN": "<YOUR_VALUE>",
        "DISCORD_MCP_HTTP_TOKEN": "<YOUR_VALUE>"
      }
    }
  }
}
  • DISCORD_TOKEN required secret — Discord bot token
  • DISCORD_MCP_TOOLSETS — Comma-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_ONLY — Set 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_GUILDS — Comma-separated guild IDs the server may act on. Calls that target any other guild are rejected. Unset allows every guild.
  • DISCORD_MESSAGE_CONTENT — Set to false to stop requesting the Message Content privileged intent at connect time.
  • DISCORD_GUILD_MEMBERS — Set to false to stop requesting the Server Members privileged intent at connect time.
  • DISCORD_MCP_TRANSPORT — stdio, 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_TOKEN secret — Bearer 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_HOST — Address 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_PORT — Port the HTTP server listens on when DISCORD_MCP_TRANSPORT is http.
  • DISCORD_MCP_HTTP_ALLOWED_HOSTS — Comma-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.

Package (oci)

docker run -i --rm -e DISCORD_TOKEN=<YOUR_VALUE> -e DISCORD_MCP_HTTP_TOKEN=<YOUR_VALUE> docker.io/pasympa/discord-mcp:2.4.0

Or add to your MCP client config:

{
  "mcpServers": {
    "discord-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DISCORD_TOKEN=<YOUR_VALUE>",
        "-e",
        "DISCORD_MCP_HTTP_TOKEN=<YOUR_VALUE>",
        "docker.io/pasympa/discord-mcp:2.4.0"
      ]
    }
  }
}
  • DISCORD_TOKEN required secret — Discord bot token
  • DISCORD_MCP_TOOLSETS — Comma-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_ONLY — Set 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_GUILDS — Comma-separated guild IDs the server may act on. Calls that target any other guild are rejected. Unset allows every guild.
  • DISCORD_MESSAGE_CONTENT — Set to false to stop requesting the Message Content privileged intent at connect time.
  • DISCORD_GUILD_MEMBERS — Set to false to stop requesting the Server Members privileged intent at connect time.
  • DISCORD_MCP_TRANSPORT — stdio, 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_TOKEN secret — Bearer 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_HOST — Address 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_PORT — Port the HTTP server listens on when DISCORD_MCP_TRANSPORT is http.
  • DISCORD_MCP_HTTP_ALLOWED_HOSTS — Comma-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.

Package (mcpb 2.4.0)

Package: mcpb https://github.com/PaSympa/discord-mcp/releases/download/v2.4.0/discord-mcp.mcpb

Related servers

Listed in punkpeye/awesome-mcp-servers (MIT)

Data from the Official MCP Registry