# discord-mcp

Gives an AI agent tools for managing Discord messages, channels, roles, moderation, and more. Connect it with a bot token.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 29
- Author: PaSympa
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/PaSympa/discord-mcp
- Updated: 2026-10-11
- HTML: https://affpapa.org/en/nevibecode/mcp/pasympa-discord-mcp

## What it does

The server exposes more than 95 tools for Discord, covering messages, channels, roles, permissions, moderation, forums, webhooks, invites, and direct messages. It can operate across multiple Discord servers rather than being tied to a single guild ID.

To run it with `npx`, provide a bot token through `DISCORD_TOKEN`. Docker and a build from source are other options. If the bot lacks a required privileged intent setting in the Discord Developer Portal, the connection can fail; portal settings also govern access to data.

Messages are fetched through the REST API, not received by subscribing to message events. Use `DISCORD_MCP_TOOLSETS` to narrow the exposed tools, or `DISCORD_ALLOWED_GUILDS` to restrict which servers the MCP server can act on.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `DISCORD_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add discord-mcp -e DISCORD_TOKEN=<DISCORD_TOKEN> -- npx -y @pasympa/discord-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add pasympa-discord-mcp --env DISCORD_TOKEN=<DISCORD_TOKEN> -- npx -y @pasympa/discord-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pasympa-discord-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@pasympa/discord-mcp"
            ],
            "env": {
                "DISCORD_TOKEN": "<DISCORD_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "pasympa-discord-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@pasympa/discord-mcp"
            ],
            "env": {
                "DISCORD_TOKEN": "<DISCORD_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e DISCORD_TOKEN=<DISCORD_TOKEN> pasympa-discord-mcp npx -y @pasympa/discord-mcp
```
Replace <…> with your own values

## When to use it
- find and manage messages in a Discord server
- create a channel and configure its roles
- inspect permissions and adjust moderation settings
- manage forums, invites, or webhooks
- limit the tools or guilds available to the MCP server

## Example prompts
- Find recent messages in this channel and summarize the discussion.
- Create an announcements channel and set its permissions.
- Review the Discord server's roles and moderation permissions.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md