Discord MCP Server

Manage a Discord server directly from your AI coding assistant. Create channels, categories, roles, set permissions, assign roles, and more — all through natural language.

Tools

Related MCP server: Discord MCP Server

Setup

1. Create a Discord bot

1. Go to https://discord.com/developers/applications

2. Click New Application → name it → Create

3. Go to Bot → Add Bot

4. Under Privileged Gateway Intents, enable:

   • Server Members Intent

   • Message Content Intent

5. Copy the Token

6. Go to OAuth2 → URL Generator

   • Scopes: bot

   • Bot Permissions: Administrator (or manually select: Manage Channels, Manage Roles, Kick Members, Manage Webhooks, Send Messages, Read Messages, View Channels)

7. Open the generated URL in your browser to invite the bot to your server

2. Configure environment

cp .env.example .env

Edit .env and paste your bot token:

DISCORD_TOKEN=your_token_here

3. Install dependencies

pip install -r requirements.txt

MCP Host Configuration

opencode

Add to opencode.json in your project root:

{
  "mcp": {
    "discord": {
      "type": "local",
      "command": ["python", "/absolute/path/to/discord_mcp_server.py"]
    }
  }
}

Restart opencode to load the server.

Claude Desktop

Edit claude_desktop_config.json (File → Settings → Developer → Edit Config):

{
  "mcpServers": {
    "discord": {
      "command": "python",
      "args": ["/absolute/path/to/discord_mcp_server.py"],
      "env": {
        "DISCORD_TOKEN": "your_token_here"
      }
    }
  }
}

Claude Code

Add to ~/.claude.json or .mcp.json in your project:

{
  "mcpServers": {
    "discord": {
      "command": "python",
      "args": ["/absolute/path/to/discord_mcp_server.py"],
      "env": {
        "DISCORD_TOKEN": "your_token_here"
      }
    }
  }
}

Cursor

Create .cursor/mcp.json in your project root (or ~/.cursor/mcp.json for global):

{
  "mcpServers": {
    "discord": {
      "command": "python",
      "args": ["/absolute/path/to/discord_mcp_server.py"],
      "env": {
        "DISCORD_TOKEN": "your_token_here"
      }
    }
  }
}

Windsurf

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

{
  "mcpServers": {
    "discord": {
      "command": "python",
      "args": ["/absolute/path/to/discord_mcp_server.py"],
      "env": {
        "DISCORD_TOKEN": "your_token_here"
      }
    }
  }
}

Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.discord]
command = "python"
args = ["/absolute/path/to/discord_mcp_server.py"]

[mcp_servers.discord.env]
DISCORD_TOKEN = "your_token_here"

Or add via CLI:

codex mcp add discord -- python /absolute/path/to/discord_mcp_server.py

Antigravity (Google)

Add to ~/.gemini/config/mcp_config.json:

{
  "mcpServers": {
    "discord": {
      "command": "python",
      "args": ["C:\\path\\to\\discord_mcp_server.py"],
      "env": {
        "DISCORD_TOKEN": "your_token_here"
      }
    }
  }
}

Open Antigravity → Agent panel → ... → MCP Servers → Manage MCP Servers → View raw config.

Note: If using the .env file instead of inline env, omit the env block and ensure load_dotenv() in the script finds your .env (the working directory depends on the host).

How it works

The script runs an MCP server over stdio that connects to Discord via the bot token. It registers all tools on startup, and your AI assistant calls them as needed. The Discord bot only needs to be in one server — it auto-selects the first guild on login.