Discord MCP Server

by cappyeoio.github.cappyeo/discord-mcpv0.31.1

Caller-owned Discord operations for AI agents with 221 typed tools and verifiable guild builds.

123Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active7d ago

Install Discord MCP server

claude mcp add cappyeo -e DISCORD_TOKEN='<discord-token>' -- npx -y @discord-mcp/cli

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

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

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

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

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

Add to .vscode/mcp.json in your workspace.

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

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

Configuration

Variable	Required	Secret	Description
DISCORD_TOKEN	yes	yes	Discord bot token. The optional Bot prefix is accepted.
DISCORD_EXPECTED_BOT_ID	—	—	Expected Discord bot ID. Startup fails if the token belongs to another bot.
ALLOWED_GUILDS	—	—	Comma-separated Discord guild IDs this deployment may operate against.

Freshness

Active — last maintenance signal 7d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-02 · 7d ago · GitHub
Latest release
2026-10-02 · 7d ago · GitHub · v0.31.1
Package published
no data · npm/PyPI
Registry entry updated
2026-10-02 · 7d ago · official registry · v0.31.1

FAQ

›How do I install the Discord MCP server in Claude Code?

Run: claude mcp add cappyeo -e DISCORD_TOKEN='<discord-token>' -- npx -y @discord-mcp/cli. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Discord require an API key?

Yes. It expects DISCORD_TOKEN, of which 1 is a secret.

›Can I use Discord as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Discord in the official MCP registry?

Yes, as io.github.cappyeo/discord-mcp.